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graphics 
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problem-driven 


fundamentals first 


examples and exercises 


Dear Reader, 

This book assumes that you are a new programmer with no prior knowledge of programming. 
So, what is programming? Programming solves problems by creating solutions—writing 
programs—in a programming language. The fundamentals of problem solving and programming 
are the same regardless of which programming language you use. You can learn programming 
using any high-level programming language such as Python, Java, or C#. Once you know 
how to program in one language, it is easy to pick up other languages, because the basic tech¬ 
niques for writing programs are the same. 

So what are the benefits of learning programming using Python? Python is easy to learn 
and fun to program. Python code is simple, short, readable, intuitive, and powerful, and thus 
it is effective for introducing computing and problem solving to beginners. 

Beginners are motivated to learn programming so they can create graphics. A big reason 
for learning programming using Python is that you can start programming using graphics on 
day one. We use Python’s built-in Turtle graphics module in Chapters 1-6 because it is a good 
pedagogical tool for introducing fundamental concepts and techniques of programming. We 
introduce Python’s built-in Tkinter in Chapter 9, because it is a great tool for developing 
comprehensive graphical user interfaces and for learning object-oriented programming. Both 
Turtle and Tkinter are remarkably simple and easy to use. More importantly, they are valuable 
pedagogical tools for teaching the fundamentals of programming and object-oriented 
programming. 

To give instructors flexibility to use this book, we cover Turtle at the end of Chapters 1-6 
so they can be skipped as optional material. 

The book teaches problem solving in a problem-driven way that focuses on problem solv¬ 
ing rather than syntax. We stimulate student interests in programming by using interesting 
examples in a broad context. While the central thread of the book is on problem solving, 
appropriate Python syntax and library are introduced in order to solve the problems. To sup¬ 
port the teaching of programming in a problem-driven way, the book provides a wide variety 
of problems at various levels of difficulty to motivate students. In order to appeal to students 
in all majors, the problems cover many application areas in math, science, business, financial 
management, gaming, animation, and multimedia. 

All data in Python are objects. We introduce and use objects from Chapter 3, but defining 
custom classes are covered in the middle of the book starting from Chapter 7. The book 
focuses on fundamentals first: it introduces basic programming concepts and techniques on 
selections, loops, and functions before writing custom classes. 

The best way to teach programming is by example, and the only way to learn programming 
is by doing. Basic concepts are explained by example and a large number of exercises with 
various levels of difficulty are provided for students to practice. Our goal is to produce a text 
that teaches problem solving and programming in a broad context using a wide variety of 
interesting examples and exercises. 

Sincerely, 

Y. Daniel Liang 
y.daniel.liang @ gmail.com 
www.es. arms trong. edu/liang 
www.pearsonhighered.com/liang 
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Pedagogical Features 

The book uses the following elements to get the most from the material: 

■ Objectives list what students should learn in each chapter. This will help them determine 
whether they have met the objectives after completing the chapter. 

■ The Introduction opens the discussion with representative problems to give the reader an 
overview of what to expect from the chapter. 

■ Key Points highlight the important concepts covered in each section. 

■ Check Points provide review questions to help students track their progress and evaluate 
their learning. 

■ Problems, carefully chosen and presented in an easy-to-follow style, teach problem 
solving and programming concepts. The book uses many small, simple, and stimulating 
examples to demonstrate important ideas. 

■ Key Terms are listed with a page number to give students a quick reference to the impor¬ 
tant terms introducd in the chapter. 

■ The Chapter Summary reviews the important subjects that students should understand 
and remember. It helps them reinforce the key concepts they have learned in the chapter. 

■ Test Questions are available online, grouped by sections for students to do self-test on 
programming concepts and techniques. 

■ Programming Exercises are grouped by sections to provide students with opportunities 
to apply on their own the new skills they have learned. The level of difficulty is rated as 
easy (no asterisk), moderate (*), hard (**), or challenging (***). The trick of learning 
programming is practice, practice, and practice. To that end, the book provides a great 
many exercises. 

■ Notes, Tips, and Cautions are inserted throughout the text to offer valuable advice and 
insight on important aspects of program development. 

Note 

Provides additional information on the subject and reinforces important concepts. 

Tip 

Teaches good programming style and practice. 

Caution 

Helps students steer away from the pitfalls of programming errors. 

Flexible Chapter Orderings 

Graphics is a valuable pedagogical tool for learning programming. The book uses Turtle 
graphics in Chapters 1-6 and Tkinter in the rest of the book. However, the book is designed to 
give the instructors the flexibility to skip the sections on graphics or to cover them later. The 
following diagram shows the chapter dependencies. 

Chapter 10, Lists can be covered right after Chapter 6, Functions. Chapter 14, Tuples, 
Sets, and Dictionaries can be covered after Chapter 10. 
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Part I: Fundamentals of Part II: Object-Oriented Part III: Data Structures and 

Programming Programming Algorithms 



Organization of the Book 

The chapters can be grouped into three parts that, taken together, form a comprehensive intro¬ 
duction to Python programming. Because knowledge is cumulative, the early chapters pro¬ 
vide the conceptual basis for understanding programming and guide students through simple 
examples and exercises; subsequent chapters progressively present Python programming in 
detail, culminating with the development of comprehensive applications. 


Part I: Fundamentals of Programming (Chapters 1-6) 

The first part of the book is a stepping stone, preparing you to embark on the journey of learn¬ 
ing programming. You will begin to know Python (Chapter 1) and will learn fundamental pro¬ 
gramming techniques with data types, variables, constants, assignments, expressions, 
operators, objects, and simple functions and string operations (Chapters 2-3), selection state¬ 
ments (Chapter 4), loops (Chapter 5), and functions (Chapter 6). 


Part II: Object-Oriented Programming (Chapters 7-13) 

This part introduces object-oriented programming. Python is an object-oriented programming 
language that uses abstraction, encapsulation, inheritance, and polymorphism to provide great 
flexibility, modularity, and reusability in developing software. You will learn object-oriented 
programming (Chapters 7-8), GUI programming using Tkinter (Chapter 9), lists (Chapter 
10), multidimensional lists (Chapter 11), inheritance, polymorphism, and class design 
(Chapter 12), and files and exception handling (Chapter 13). 

Part III: Data Structures and Algorithms (Chapters 14-15 and Bonus Chapters 16-23) 

This part introduces the main subjects in a typical data structures course. Chapter 14 intro¬ 
duces Python built-in data structures: tuples, sets, and dictionaries. Chapter 15 introduces 
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recursion to write functions for solving inherently recursive problems. Chapters 16-23 are 
bonus chapters on the Companion Website. Chapter 16 introduces measurement of algorithm 
efficiency and common techniques for developing efficient algorithms. Chapter 17 discusses 
classic sorting algorithms. You will learn how to implement linked lists, queues, and priority 
queues in Chapter 18. Chapter 19 presents binary search trees, and you will learn about AVL 
trees in Chapter 20. Chapter 21 introduces hashing, and Chapters 22 and 23 cover graph algo¬ 
rithms and applications. 

Student Resource Website 

The Student Resource Website (www.cs.armstrong.edu/liang/py) contains the following resources: 

■ Answers to review questions 

■ Solutions to even-numbered programming exercises 

■ Source code for the examples in the book 

■ Interactive self-test questions (organized by sections for each chapter) 

■ Supplements on using Python IDEs, advanced topics, etc. 

■ Resource links 

■ Errata 

Additional Supplements 

The text covers the essential subjects. The supplements extend the text to introduce additional 
topics that might be of interest to readers. The supplements listed in this table are available 
from the Companion Website. 

Part I. General Supplements 

A. Glossary 

B. Installing and Using Python 

C. Python IDLE 

D. Python on Eclipse 

E. Python on Eclipse Debugging 

F. Python Coding Style Guidelines 

Part II. Advanced Python Topics 

A. Regular Expressions 

B. Obtaining Date and Time 

C. The str Class’s format Method 

D. Pass Arguments from Command Line 

E. Database Programming 

Instructor Resource Website 

The Instructor Resource Website, accessible from www.cs.armstrong.edu/liang/py, contains the 
following resources: 

■ Microsoft PowerPoint slides with interactive buttons to view full-color, syntax-highlighted 
source code and to run programs without leaving the slides. 

■ Solutions to all the review questions and exercises. Students will have access to the solu¬ 
tions of even-numbered programming exercises. 

■ Web-based quiz generator. (Instructors can choose chapters to generate quizzes from a 
large database of more than 800 questions.) 
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VideoNote 


■ Sample exams. In general, each exam has four parts: 

■ Multiple-choice questions or short-answer questions 

■ Correct programming errors 

■ Trace programs 

■ Write programs 

■ Projects. In general, each project gives a description and asks students to analyze, design, 
and implement the project. 

Some readers have requested the materials from the Instructor Resource Website. Please 
understand that these are for instructors only. Such requests will not be answered. 

Online Practice and Assessment 
with MyProgrammingLab 

MyProgrammingLab helps students fully grasp the logic, semantics, and syntax of program¬ 
ming. Through practice exercises and immediate, personalized feedback, MyProgrammingLab 
improves the programming competence of beginning students who often struggle with the basic 
concepts and paradigms of popular high-level programming languages. 

A self-study and homework tool, a MyProgrammingLab course consists of hundreds of 
small practice problems organized around the structure of this textbook. For students, the 
system automatically detects errors in the logic and syntax of their code submissions and 
offers targeted hints that enable students to figure out what went wrong—and why. For 
instructors, a comprehensive gradebook tracks correct and incorrect answers and stores the 
code inputted by students for review. 

MyProgrammingLab is offered to users of this book in partnership with Turing’s Craft, the 
makers of the CodeLab interactive programming exercise system. For a full demonstration, to 
see feedback from instructors and students, or to get started using MyProgrammingLab in 
your course, visit www.myprogramminglab.com. 

VideoNotes 

VideoNotes are Pearson’s new visual tool designed for teaching students key programming con¬ 
cepts and techniques. These short step-by-step videos demonstrate how to solve problems from 
design through coding. VideoNotes allow for self-placed instruction with easy navigation includ¬ 
ing the ability to select, play, rewind, fast-forward, and stop within each VideoNote exercise. 

Margin icons in your textbook let you know when a VideoNote video is available for a par¬ 
ticular concept or homework problem. 

LiveLab 

This book is accompanied by a complementary Web-based course assessment and manage¬ 
ment system for instructors. The system has four main components: 

■ The Automatic Grading System can automatically grade programs. 

■ The Quiz Creation/Submission/Grading System enables instructors to create and mod¬ 
ify quizzes that students can take and be graded upon automatically. 

■ The Peer Evaluation System enables peer evaluations. 

■ Checking plagiarisms, tracking grades, attendance, etc., lets students track their grades, 
and enables instructors to view the grades of all students, to check plagiarisms, and to track 
students’ attendance. 
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The main features of the Automatic Grading System include: 

■ Students can run and submit exercises. (The system checks whether their program runs 
correctly—students can continue to run and resubmit the program before the due date.) 

■ Instructors can review submissions, run programs with instructor test cases, correct them, 
and provide feedback to students. 

■ Instructors can create/modify their own exercises, create public and secret test cases, as¬ 
sign exercises, and set due dates for the whole class or for individuals. 

■ All the exercises in the text can be assigned to students. Additionally, LiveLab provides 
extra exercises that are not printed in the text. 

■ Instructors can sort and filter all exercises and check grades (by time frame, student, 
and/or exercise). 

■ Instructors can check plagiarisms for a programming exercise. 

■ Instructors can delete students from the system. 

■ Students and instructors can track grades on exercises. 

The main features of the Quiz System are: 

■ Instructors can create/modify quizzes from the test bank or a text file or create completely 
new tests online. 

■ Instructors can assign the quizzes to students and set a due date and test time limit for the 
whole class or for individuals. 

■ Students and instructors can review submitted quizzes. 

■ Instructors can analyze quizzes and identify students’ weaknesses. 

■ Students and instructors can track grades on quizzes. 

The main features of the Peer Evaluation System include: 

■ Instructors can assign/unassign exercises for peer evaluation. 

■ Instructors can view peer evaluation reports. 
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objectives 

■ To demonstrate a basic understanding of computer hardware, 
programs, and operating systems (§§1.2-1.4). 

■ To describe the history of Python (§1.5). 

■ To explain the basic syntax of a Python program (§ 1.6). 

■ To write and run a simple Python program (§1.6). 

■ To explain the importance of, and provide examples of, 
proper programming style and documentation (§1.7). 

■ To explain the differences between syntax errors, runtime errors, 
and logic errors (§1.8). 


■ To create a basic graphics program using Turtle (§ 1.9). 
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The central theme of this book is to learn how to solve problems by writing a program. 

This book is about programming. So, what is programming? The term programming means to 
create (or develop) software, which is also called a program. In basic terms, software contains 
the instructions that tell a computer—or a computerized device—what to do. 

Software is all around you, even in devices that you might not think would need it. Of 
course, you expect to find and use software on a personal computer, but software also plays a 
role in running airplanes, cars, cell phones, and even toasters. On a personal computer, you 
use word processors to write documents, Web browsers to explore the Internet, and e-mail 
programs to send messages. These programs are all examples of software. Software develop¬ 
ers create software with the help of powerful tools called programming languages. 

This book teaches you how to create programs by using the Python programming 
language. There are many programming languages, some of which are decades old. Each 
language was invented for a specific purpose—to build on the strengths of a previous lan¬ 
guage, for example, or to give the programmer a new and unique set of tools. Knowing that 
there are so many programming languages available, it would be natural for you to wonder 
which one is best. But, in truth, there is no “best” language. Each one has its own strengths 
and weaknesses. Experienced programmers know that one language might work well in some 
situations, whereas a different language may be more appropriate in other situations. For this 
reason, seasoned programmers try to master as many different programming languages as 
they can, giving them access to a vast arsenal of software-development tools. 

If you learn to program using one language, you should find it easy to pick up other 
languages. The key is to learn how to solve problems using a programming approach. That is 
the main theme of this book. 

You are about to begin an exciting journey: learning how to program. At the outset, it 
is helpful to review computer basics, programs, and operating systems. If you are already 
familiar with such terms as CPU, memory, disks, operating systems, and programming 
languages, you may skip the review in Sections 1.2-1.4. 


hardware 

software 


bus 


1.2 What Is a Computer? 

A computer is an electronic device that stores and processes data. 

Point ^ computer includes both hardware and software. In general, hardware comprises the visible, 
physical elements of the computer, and software provides the invisible instructions that control 
the hardware and make it perform specific tasks. Knowing computer hardware isn’t essential 
to learning a programming language, but it can help you better understand the effects that a 
program’s instructions have on the computer and its components. This section introduces com¬ 
puter hardware components and their functions. 

A computer consists of the following major hardware components (Figure 1.1): 

■ A central processing unit (CPU) 

■ Memory (main memory) 

■ Storage devices (such as disks and CDs) 

■ Input devices (such as the mouse and keyboard) 

■ Output devices (such as monitors and printers) 

■ Communication devices (such as modems and network interface cards) 

A computer’s components are interconnected by a subsystem called a bus. You can think 
of a bus as a sort of system of roads running among the computer’s components; data and 
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Figure 1.1 A computer consists of a CPU, memory, storage devices, input devices, output 
devices, and communication devices. 


power travel along the bus from one part of the computer to another. In personal computers, 
the bus is built into the computer’s motherboard, which is a circuit case that connects all of 
the parts of a computer together, as shown in Figure 1.2. 

1.2.1 Central Processing Unit 

The central processing unit (CPU) is the computer’s brain. It retrieves instructions from 
memory and executes them. The CPU usually has two components: a control unit and an 
arithmetic/logic unit. The control unit controls and coordinates the actions of the other 
components. The arithmetic/logic unit performs numeric operations (addition, subtraction, 
multiplication, division) and logical operations (comparisons). 

Today’s CPUs are built on small silicon semiconductor chips that contain millions of tiny 
electric switches, called transistors, for processing information. 

Every computer has an internal clock, which emits electronic pulses at a constant rate. 
These pulses are used to control and synchronize the pace of operations. A higher clock speed 
enables more instructions to be executed in a given period of time. The unit of measurement of 
clock speed is the hertz (Hz), with 1 hertz equaling 1 pulse per second. In the 1990s computers 
measured clocked speed in megahertz, but CPU speed has been improving continuously, and 


motherboard 

CPU 


speed 
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CPU is placed 
under the fan 


Figure 1.2 The motherboard connects all parts of computer together. 



Motherboard 


Memory 


gigahertz the clock speed of a computer is now usually stated in gigahertz (GHz). Intel’s newest proces¬ 

sors run at about 3 GHz. 

core CPUs were originally developed with only one core. The core is the part of the processor 

that performs the reading and executing of instructions. In order to increase CPU processing 
power, chip manufacturers are now producing CPUs that contain multiple cores. A multicore 
CPU is a single component with two or more independent processors. Today’s consumer 
computers typically have two, three, and even four separate cores. Soon, CPUs with tens or 
even hundreds of cores will be affordable. 

1.2.2 Bits and Bytes 

Before we discuss memory, let’s look at how information (data and programs) are stored in a 
computer. 

A computer is really nothing more than a series of switches. Each switch exists in two 
states: on or off. Storing information in a computer is simply a matter of setting a sequence 
of switches on or off. If the switch is on, its value is 1. If the switch is off, its value is 0. 
bits These Os and Is are interpreted as digits in the binary number system and called bits (binary 

digits). 

byte The minimum storage unit in a computer is a byte. A byte is composed of eight bits. A 

small number such as 3 can be stored as a single byte. To store a number that cannot fit 
into a single byte, the computer uses several bytes. 

Data of various kinds, such as numbers and characters, are encoded as a series of bytes. As 
a programmer, you don’t need to worry about the encoding and decoding of data, which the 
computer system performs automatically, based on the encoding scheme. An encoding 
encoding scheme scheme is a set of rules that govern how a computer translates characters, numbers, and sym¬ 

bols into data the computer can actually work with. Most schemes translate each character 
into a predetermined string of numbers. In the popular ASCII encoding scheme, for example, 
the character C is represented as 01000011 in one byte. 
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A computer’s storage capacity is measured in bytes and multiples of the byte, as follows: 

■ A kilobyte (KB) is about 1,000 bytes. 

■ A megabyte (MB) is about 1 million bytes. 

■ A gigabyte (GB) is about 1 billion bytes. 

■ A terabyte (TB) is about 1 trillion bytes. 

A typical one-page word document might take 20 KB. So 1 MB can store 50 pages of doc¬ 
uments and 1 GB can store 50000 pages of documents. A typical two-hour high-resolution 
movie might take 8 GB. So it would require 160 GB to store 20 movies. 


1.2.3 Memory 

A computer’s memory consists of an ordered sequence of bytes for storing programs as well 
as data that the program is working with. You can think of memory as the computer’s work 
area for executing a program. A program and its data must be moved into the computer’s 
memory before they can be executed by the CPU. 

Every byte in the memory has a unique address, as shown in Figure 1.3. The address is 
used to locate the byte for storing and retrieving the data. Since the bytes in the memory can 
be accessed in any order, the memory is also referred to as random-access memory (RAM). 


Memory 


address Memory content 

i I 


2000 

2001 

2002 

2003 

2004 


01000011 


01110010 


01100101 


01110111 


00000011 


Encoding for character ‘C’ 
Encoding for character ‘r’ 
Encoding for character ‘e’ 
Encoding for character ‘w’ 
Encoding for number 3 


Figure 1.3 Memory stores data and program instructions in uniquely addressed memory 
locations. Each memory location can store one byte of data. 


Today’s personal computers usually have at least 1 gigabyte of RAM, but they more com¬ 
monly have 2 to 4 GB installed. Generally speaking, the more RAM a computer has, the faster 
it can operate, but there are limits to this simple rule of thumb. 

A memory byte is never empty, but its initial content may be meaningless to your program. 
The current content of a memory byte is lost whenever new information is placed in it. 

Like the CPU, memory is built on silicon semiconductor chips that have millions of 
transistors embedded on their surface. Compared to CPU chips, memory chips are less com¬ 
plicated, slower, and less expensive. 


1.2.4 Storage Devices 

A computer’s memory is a volatile form of data storage: any information that hasn’t been stored 
in memory (that is, saved) is lost when the system’s power is turned off. Programs and data are 
permanently stored on storage devices and are moved, when the computer actually uses them, to 
memory, which operates at much faster speeds than permanent storage devices can. 


kilobyte (KB) 
megabyte (MB) 
gigabyte (GB) 
terabyte (TB) 
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There are three main types of storage devices: 

■ Magnetic disk drives 

■ Optical disc drives (CD and DVD) 

■ USB flash drives 

Drives are devices for operating a medium, such as disks and CDs. A storage medium physi¬ 
cally stores data or program instructions. The drive reads data from the medium and/or writes 
data onto the medium. 

Disks 

A computer usually has at least one hard disk drive (Figure 1.4). Hard disks are used for per¬ 
manently storing data and programs. Newer computers have hard disks that can store from 200 
to 800 gigabytes of data. Hard disk drives are usually encased inside the computer, but remov¬ 
able hard disks are also available. 



Figure 1.4 A hard disk is a device for permanently storing programs and data. 


CDs and DVDs 

CD stands for compact disc. There are two types of CD drives: CD-R and CD-RW. A CD-R 
is for read-only permanent storage; the user cannot modify its contents once they are 
recorded. A CD-RW can be used like a hard disk; that is, you can write data onto the disc, 
and then overwrite that data with new data. A single CD can hold up to 700 MB. Most new 
PCs are equipped with a CD-RW drive that can work with both CD-R and CD-RW discs. 

DVD stands for digital versatile disc or digital video disc. DVDs and CDs look alike, and you 
can use either to store data. A DVD can hold more information than a CD; a standard DVD’s 
storage capacity is 4.7 GB. Like CDs, there are two types of DVDs: DVD-R (read-only) and 
DVD-RW (rewritable). 
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USB Flash Drives 

Universal serial bus (USB) connectors allow the user to attach many kinds of peripheral devices 
to the computer. You can use a USB to connect a printer, digital camera, mouse, external hard 
disk drive, and other devices to the computer. 

A USB flash drive is a device for storing and transporting data. A flash drive is small— 
about the size of a pack of gum, as shown in Figure 1.5. It acts like a portable hard drive that 
can be plugged into your computer’s USB port. USB flash drives are currently available with 
up to 256 GB storage capacity. 



Figure 1.5 USB flash drives are popular portable devices for storing data. 

1.2.5 Input and Output Devices 

Input and output devices let the user communicate with the computer. The most common input 
devices are keyboards and mice. The most common output devices are monitors and printers. 

The Keyboard 

A keyboard is a device for entering input. A typical keyboard is shown in Figure 1.6. Compact 
keyboards are available without a numeric keypad. 


Modifier 



Function 


Insert 


Delete 


Page Up 


- Page Down 

Numeric Keypad 


Arrows 


Figure 1.6 A computer keyboard consists of the keys for sending input to a computer. 

Function keys are located across the top of the keyboard and are prefaced with the letter F. function key 
Their functions depend on the software currently being used. 
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A modifier key is a special key (such as the Shift, Alt, and Ctrl keys) that modifies the 
normal action of another key when the two are pressed simultaneously. 

The numeric keypad, located on the right side of most keyboards, is a separate set of keys 
styled like a calculator to use for entering numbers quickly. 

Arrow keys, located between the main keypad and the numeric keypad, are used to move 
the mouse pointer up, down, left, and right on the screen in many kinds of programs. 

The Insert, Delete, Page Up, and Page Down keys are used in word processing and other 
programs for inserting text and objects, deleting text and objects, and moving up or down 
through a document one screen at a time. 

The Mouse 

A mouse is a pointing device. It is used to move a graphical pointer (usually in the shape of an 
arrow) called a cursor around the screen or to click on-screen objects (such as a button) to 
trigger them to perform an action. 

The Monitor 

The monitor displays information (text and graphics). The screen resolution and dot pitch 
determine the quality of the display. 

The screen resolution specifies the number of pixels in horizontal and vertical dimensions 
of the display device. Pixels (short for “picture elements”) are tiny dots that form an image on 
the screen. A common resolution for a 17-inch screen, for example, is 1024 pixels wide and 
768 pixels high. The resolution can be set manually. The higher the resolution, the sharper and 
clearer the image is. 

The dot pitch is the amount of space between pixels, measured in millimeters. The smaller 
the dot pitch, the sharper the display. 

1.2.6 Communication Devices 

Computers can be networked through communication devices, such as a dial-up modem 
(fwodulator/(7emodulator), a DSL or cable modem, a wired network interface card, or a wire¬ 
less adapter. 

■ A dial-up modem uses a phone line and can transfer data at a speed up to 56,000 bps 
(bits per second). 

■ A digital subscriber line (DSL) connection also uses a standard phone line, but it can 
transfer data 20 times faster than a standard dial-up modem. 

■ A cable modem uses the cable TV line maintained by the cable company and is 
generally faster than DSL. 

■ A network interface card (NIC) is a device that connects a computer to a local area 
network (LAN), as shown in Figure 1.7. LANs are commonly used in universities, 
businesses, and government agencies. A high-speed NIC called lOOOBaseT can 
transfer data at 1,000 million bits per second (mbps). 

■ Wireless networking is now extremely popular in homes, businesses, and schools. 
Every laptop computer sold today is equipped with a wireless adapter that enables 
the computer to connect to a local area network and the Internet. 


Note 

Answers to checkpoint questions are on the Companion Website. 
I. I What are hardware and software? 

1.2 List five major hardware components of a computer. 

1.3 What does the acronym “CPU” stand for? 
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Figure 1.7 A local area network connects computers in close proximity to each other. 

1.4 What unit is used to measure CPU speed? 

1.5 What is a hit? What is a byte? 

1.6 What is memory for? What does RAM stand for? Why is memory called RAM? 

1.7 What unit is used to measure memory size? 

1.8 What unit is used to measure disk size? 

1.9 What is the primary difference between memory and a storage device? 


1.3 Programming Languages 

Computer programs, known as software, are instructions that tell a computer what to do. 

Computers do not understand human languages, so programs must be written in a language a 
computer can use. There are hundreds of programming languages, and they were developed to 
make the programming process easier for people. However, all programs must be converted 
into a language the computer can understand. 

1.3.1 Machine Language 

A computer’s native language, which differs among different types of computers, is its machine machine language 
language —a set of built-in primitive instructions. These instructions are in the form of binary 
code, so if you want to give a computer an instruction in its native language, you have to enter 


Key 

Point 
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the instruction as binary code. For example, to add two numbers, you might have to write an 
instruction in binary code, like this: 

1101101010011010 

1.3.2 Assembly Language 

Programming in machine language is a tedious process. Moreover, programs written in 
assembly language machine language are very difficult to read and modify. For this reason, assembly language 

was created in the early days of computing as an alternative to machine languages. Assembly 
language uses a short descriptive word, known as mnemonic, to represent each of the machine- 
language instructions. For example, the mnemonic add typically means to add numbers and 
sub means to subtract numbers. To add the numbers 2 and 3 and get the result, you might write 
an instruction in assembly code like this: 

add 2, 3, result 

Assembly languages were developed to make programming easier. Flowever, because the 
assembler computer cannot understand assembly language, another program—called an assembler —is 

used to translate assembly-language programs into machine code, as shown in Figure 1.8. 


Assembler 


Figure 1.8 An assembler translates assembly-language instructions into machine code. 

Writing code in assembly language is easier than in machine language. However, it is still 
tedious to write code in assembly language. An instruction in assembly language essentially 
corresponds to an instruction in machine code. Writing in assembly requires that you know how 
low-level language the CPU works. Assembly language is referred to as a low-level language, because assembly 

language is close in nature to machine language and is machine dependent. 

1.3.3 High-Level Language 

In the 1950s, a new generation of programming languages known as high-level languages 
emerged. They are platform-independent, which means that you can write a program in a high- 
level language and run it in different types of machines. High-level languages are English-like 
and easy to learn and use. The instructions in a high-level programming language are called 
statements. Here, for example, is a high-level language statement that computes the area of a 
circle with a radius of 5: 

area =5*5* 3.1415 

There are many high-level programming languages, and each was designed for a specific 
purpose. Table 1.1 lists some popular ones. 

A program written in a high-level language is called a source program or source code. 
Because a computer cannot understand a source program, a source program must be translated 
into machine code for execution. The translation can be done using another programming tool 
called an interpreter or a compiler. 

■ An interpreter reads one statement from the source code, translates it to the machine 
code or virtual machine code, and then executes it right away, as shown in Figure 1.9a. 


source program 
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Table 1.1 Popular High-Level Programming Languages 


Language Description 


Ada 

BASIC 

C 

C-i-i- 

c# 

COBOL 

FORTRAN 

Java 

Pascal 

Python 
Visual Basic 


Named for Ada Lovelace, who worked on mechanical general-purpose computers. The Ada language was 
developed for the Department of Defense and is used mainly in defense projects. 

Beginner’s All-purpose Symbolic Instruction Code. It was designed to be learned and used easily by beginners. 

Developed at Bell Laboratories. C combines the power of an assembly language with the ease of use and portability 
of a high-level language. 

C-l-l- is an object-oriented language, based on C. 

Pronounced “C Sharp.” It is a hybrid of Java and C-l-l- and was developed by Microsoft, 
common Business Oriented Language. Used for business applications. 

FORmula TRANslation. Popular for scientific and mathematical applications. 

Developed by Sun Microsystems, now part of Oracle. It is widely used for developing platform-independent 
Internet applications. 

Named for Blaise Pascal, who pioneered calculating machines in the seventeenth century. It is a simple, structured, 
general-purpose language primarily for teaching programming. 

A simple general-purpose scripting language good for writing short programs. 

Visual Basic was developed by Microsoft and it enables the programmers to rapidly develop Windows-based 
applications. 




(b) 


Figure 1.9 (a) An interpreter translates and executes a program one statement at a time, (b) A compiler translates the entire 

source program into a machine-language file for execution. 


Note that a statement from the source code may be translated into several machine 
instructions. 

■ A compiler translates the entire source code into a machine-code file, and the 
machine code file is then executed, as shown in Figure 1.9b. 

Python code is executed using an interpreter. Most other programming languages are 
processed using a compiler. 


1. 10 What language does the CPU understand? 
I. I I What is an assembly language? 
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1.12 What is an assembler? 

1.13 What is a high-level programming language? 

1.14 What is a source program? 

1.15 What is an interpreter? 

1.16 What is a compiler? 

1.17 What is the difference between an interpreted language and a compiled language? 

1.4 Operating Systems 

The operating system (OS) is the most important program that runs on a computer. 

The OS manages and controls a computer’s activities. 

The popular operating systems for general-purpose computers are Microsoft Windows, Mac 
OS, and Linux. Application programs, such as a Web browser or a word processor, cannot run 
unless an operating system is installed and running on the computer. Figure 1.10 shows the 
interrelationship of hardware, operating system, application software, and the user. 


User 


Application Programs 


Operating System 


Hardware 


Figure 1.10 Users and applications access the computer’s hardware via the operating system. 


The major tasks of an operating system are; 

■ Controlling and monitoring system activities 

■ Allocating and assigning system resources 

■ Scheduling operations 

1.4.1 Controlling and Monitoring System Activities 

Operating systems perform basic tasks, such as recognizing input from the keyboard, sending 
output to the monitor, keeping track of files and folders on storage devices, and controlling 
peripheral devices, such as disk drives and printers. An operating system must also ensure that 
different programs and users working at the same time do not interfere with each other. In 
addition, the OS is responsible for security, ensuring that unauthorized users and programs do 
not access the system. 

1.4.2 Allocating and Assigning System Resources 

The operating system is responsible for determining what computer resources a program 
needs (such as CPU time, memory space, disks, input and output devices) and for allocating 
and assigning them to run the program. 
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1 . 4.3 Scheduling Operations 

The OS is responsible for scheduling programs’ activities to make efficient use of system 
resources. Many of today’s operating systems support such techniques as multiprogramming, 
multithreading, and multiprocessing to increase system performance. 

Multiprogramming allows multiple programs to run simultaneously by sharing the same 
CPU. The CPU is much faster than the computer’s other components. As a result, it is idle 
most of the time—for example, while waiting for data to be transferred from a disk or waiting 
for other system resources to respond. A multiprogramming OS takes advantage of this situa¬ 
tion by allowing multiple programs to use the CPU when it would otherwise be idle. For 
example, multiprogramming enables you to use a word processor to edit a file at the same 
time as your Web browser is downloading a file. 

Multithreading allows a single program to execute multiple tasks at the same time. For 
instance, a word-processing program allows users to simultaneously edit text and save it to a 
disk. In this example, editing and saving are two tasks within the same application. These two 
tasks may run concurrently. 

Multiprocessing, or parallel processing, uses two or more processors together to per¬ 
form subtasks concurrently and then combine solutions of the subtasks to obtain a solution 
for the entire task. It is like a surgical operation where several doctors work together on one 
patient. 

1.18 What is an operating system? List some popular operating systems. 

1.19 What are the major responsibilities of an operating system? 

1.20 What are multiprogramming, multithreading, and multiprocessing? 

1.5 The History of Python 

Python is a general-purpose, interpreted, object-oriented programming language. 

Python was created by Guido van Rossum in the Netherlands in 1990 and was named after 
the popular British comedy troupe Monty Python’s Flying Circus. Van Rossum developed 
Python as a hobby, and Python has become a popular programming language widely used 
in industry and academia due to its simple, concise, and intuitive syntax and extensive 
library. 

Python is a general-purpose programming language. That means you can use Python to 
write code for any programming task. Python is now used in the Google search engine, in 
mission-critical projects at NASA, and in transaction processing at the New York Stock 
Exchange. 

Python is interpreted, which means that Python code is translated and executed by an inter¬ 
preter, one statement at a time, as described earlier in the chapter. 

Python is an object-oriented programming (OOP) language. Data in Python are objects 
created from classes. A class is essentially a type or category that defines objects of the same 
kind with properties and methods for manipulating objects. Object-oriented programming is a 
powerful tool for developing reusable software. Object-oriented programming in Python will 
be covered in detail starting in Chapter 7. 

Python is now being developed and maintained by a large team of volunteers and is avail¬ 
able for free from the Python Software Foundation. Two versions of Python are currently 
coexistent: Python 2 and Python 3. The programs written in Python 3 will not run in Python 
2. Python 3 is a newer version, but it is not backward-compatible with Python 2. This means 
that if you write a program using the Python 2 syntax, it may not work with a Python 3 inter¬ 
preter. Python provides a tool that automatically converts code written in Python 2 into syntax 
Python 3 can use. Python 2 will eventually be replaced by Python 3. This book teaches pro¬ 
gramming using Python 3. 
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1.21 Python is interpreted. What does that mean? 

1.22 Can a program written in Python 2 run in Python 3? 

1.23 Can a program written using Python 3 run in Python 2? 


console 
console input 
console output 




1.6 Getting Started with Python 

A Python program is executed from the Python interpreter. 

Let’s get started by writing a simple Python program that displays the messages Wei come 
to Python and Python is fun on the console. The word console is an old computer 
term that refers to the text entry and display device of a computer. Console input means 
to receive input from the keyboard and console output means to display output to the 
monitor. 


Note 

You can run Python on the Windows, UNIX, and Mac operating systems. For informa- 
install Python tion on installing Python, see Supplement I.B, Installing and Using Python, on the 

Companion Website. 



& 


VideoNote 

Start with Python 

IDLE 


1.6.1 Launching Python 

Assume you have Python installed on the Windows OS. You can start Python in a com¬ 
mand window by typing python at the command prompt, as shown in Figure 1.11, or by 
using IDLE, as shown in Figure 1.12. IDLE (/nteractive DeveLopment Environment) is an 
integrated development environment (IDE) for Python. You can create, open, save, edit, 
and run Python programs in IDLE. Both the command-line Python interpreter and IDLE 
are available after Python is installed on your machine. Note that Python (command line) 


^ra"~ X'-* 


D:\Python32>python 

Ipython 3.2.1 <default, Jul 10 2011, 21:51:15> EMSC v.1500 32 bit <Intel>] on win- 
32 

jlype "help'', "copyright", "credits" or ''license" for nore infornation. 

>>> print<''Weleone to Python") 

]Ueleone to Python 
>>> print<''Python is fun"> 

[Python is fun 

r»> 

:\Python32> 


Figure 1.11 You can launch Python from the command window. 



Figure 1.12 You can use Python from IDLE. 
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Figure 1.13 You can launch the Python IDLE and command line from the Start button. 


and IDLE can also be accessed directly from the Windows Start button by searching for 
Python (command line) or IDLE (Python GUI) on Windows 7 or Vista, as shown in 
Eigure 1.13. 

After Python starts, you will see the symbol »>. This is the Python statement prompt, and 
it is where you can enter a Python statement. 

Note 

Type the commands exactly as they are written in this text. Formatting and other rules 
will be discussed later in this chapter. 

Now, type printC'Wel come to Python") and press the Enter key. The string Wei come 
to Python appears on the console, as shown in Figure 1.11. String is a programming term 
meaning a sequence of characters. 

Note 

Note that Python requires double or single quotation marks around strings to delineate 
them from other code. As you can see in the output, Python doesn’t display those 
quotation marks. 

The print statement is one of Python’s huilt-in functions that can be used to display a 
string on the console. A function performs actions. In the case of the print function, it dis¬ 
plays a message to the console. 

Note 

In programming terminology, when you use a function, you are said to be "inuoking a 
function" or "calling a function." 

Next, type print ("Python is fun") and press the Enter key. The string Python is 
fun appears on the console, as shown in Figure 1.11. You can enter additional statements at 
the statement prompt »>. 

Note 

To exit Python, press CTRL+Z and then the Enter key. 






Python statement prompt »> 


string 


function 


invoking a function 
calling a function 
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source file 
script file 
module 
.py file 
script mode 
interactive mode 


Python on Eclipse 


comment 
print a message 

line numbers 
execute the program 


comment 

line comment 
paragraph comment 


1.6.2 Creating Python Source Code Files 

Entering Python statements at the statement prompt >» is convenient, but the statements are 
not saved. To save statements for later use, you can create a text file to store the statements 
and use the following command to execute the statements in the file: 

python filename.py 

The text file can be created using a text editor such as Notepad. The text file, filename, is 
called a Python source file or script file, or module. By convention. Python files are named 
with the extension . py. 

Running a Python program from a script file is known as running Python in script mode. 
Typing a statement at the statement prompt »> and executing it is called running Python in 
interactive mode. 


Note 

Besides developing and running Python programs from the command window, you can 
create, save, modify, and run a Python script from IDLE. For information on using IDLE, 
see Supplement I.C on the Companion Website. Your instructor may also ask you to use 
Eclipse. Eclipse is a popular interactive development environment (IDE) used to develop 
programs quickly. Editing, running, debugging, and online help are integrated in one 
graphical user interface. If you want to develop Python programs using Eclipse, see 
Supplement I.D, on the Companion Website. 


Listing 1 . 1 shows you a Python program that displays the messages Wei come to Python 
and Python is fun. 


Listing 1.1 Wei come, py 

1 # Display two messages 

2 pri ntC'Welcome to Python”) 

3 pri ntC'Python is fun") 

In this text, line numbers are displayed for reference purposes; they are not part of the pro¬ 
gram. So, don’t type line numbers in your program. 

Suppose the statements are saved in a file named Welcome.py. To run the program, enter 
python Welcome.py at the command prompt, as shown in Figure 1.14. 



Figure 1.14 You can run a Python script file from a command window. 


In Listing 1.1, line 1 is a comment that documents what the program is and how it is con¬ 
structed. Comments help programmers communicate and understand a program. They are not 
programming statements and thus are ignored by the interpreter. In Python, comments are 
preceded by a pound sign (f) on a line, called a line comment, or enclosed between three con¬ 
secutive single quotation marks ( ' ' ' ) on one or several lines, called a paragraph comment. 
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When the Python interpreter sees #, it ignores all text after # on the same line. When it sees 
' ' ' , it scans for the next ’ and ignores any text between the triple quotation marks. Here 
are examples of comments: 

# This program displays Welcome to Python 

''' This program displays Welcome to Python and 
Python is fun 

I I I 


Indentation matters in Python. Note that the statements are entered from the first column in 
the new line. The Python interpreter will report an error if the program is typed as follows: 

# Display two messages 
printC'Welcome to Python") 

pri ntC'Python is fun") 

Don’t put any punctuation at the end of a statement. For example, the Python interpreter 
will report errors for the following code: 

# Display two messages 

printC'Welcome to Python"). 

pri ntC'Python is fun"), 

Python programs are case sensitive. It would be wrong, for example, to replace print in 
the program with Print. 

You have seen several special characters (#, ", ()) in the program. They are used in 
almost every program. Table 1.2 summarizes their uses. 


Table 1.2 Special Characters 

Character Name 

C) Opening and closing parentheses 

# Pound sign 

" " Opening and closing quotation marks 

III III Paragraph comments 


Description 
Used with functions. 

Precedes a comment line. 

Encloses a string (i.e., sequence of characters). 
Encloses a paragraph comment. 


The program in Listing 1.1 displays two messages. Once you understand the program, it is 
easy to extend it to display more messages. For example, you can rewrite the program to dis¬ 
play three messages, as shown in Listing 1.2. 

Listing 1.2 WelcomeWithThreeMessages.py 

1 # Display three messages 

2 printC'Welcome to Python") 

3 pri ntC'Python is fun") 

4 pri ntC'Problem Driven") 


Welcome to Python 
Python is fun 
Problem Driven 


indentation 



case sensitive 
special characters 


comment 
print statement 







18 Chapter 


Introduction to Computers, Programs, and Python 


1.6.3 Using Python to Perform Mathematical Computations 

Python programs can perform all sorts of mathematical computations and display the result. 
To display the addition, subtraction, multiplication, and division of two numbers, x and y, use 
the following code: 


printCx + y) 
printCx - y) 
print(x * y) 
printCx / y) 


Listing 1.3 shows an example of a program that evaluates 


10.5 + 2X3 
45 - 3.5 


and prints its result. 


Listing 1.3 ComputeExpression.py 

comment 1 # Compute expression 

compute expression 2 print((10.5 + 2*3)/ (45 - 3.5)) 


0.397590361446 


As you can see, it is a straightforward process to translate an arithmetic expression to a 
Python expression. We will discuss Python expressions further in Chapter 2. 
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1.24 You can run Python in two modes. Explain these two modes. 

1.25 Is Python case sensitive? 

1.26 What is the Python source filename extension by convention? 

1.27 What is the command to run a Python source file? 

1.28 What is a comment? How do you denote a comment line and a comment paragraph? 

1.29 What is the statement to display the message He! 1 o worl d on the console? 

1.30 Identify and fix the errors in the following code: 

1 # Display two messages 

2 printC'Welcome to Python") 

3 pri ntC’Python is fun"). 


1.3 I Show the output of the following code: 
print("3.5 * 4 / 2 - 2.5 is") 
print(3.5 * 4 / 2 - 2.5) 


.r/Key 

Ip / Point 


1.7 Programming Style and Documentation 

Good programming style and proper documentation make a program easy to read and 
prevents errors. 


programming style Programming style deals with what programs look like. When you create programs with a 

professional programming style, they not only execute properly but are easy for people to 
read and understand. This is very important if other programmers will access or modify your 
programs. 

documentation Documentation is the body of explanatory remarks and comments pertaining to a program. 

These remarks and comments explain various parts of the program and help others understand 
its structure and function. As you saw earlier in the chapter, remarks and comments are 
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embedded within the program itself; Python’s interpreter simply ignores them when the pro¬ 
gram is executed. 

Programming style and documentation are as important as coding. Here are a few guidelines. 


1.7.1 Appropriate Comments and Comment Styles 

Include a summary comment at the heginning of the program to explain what the program 
does, its key features, and any unique techniques it uses. In a long program, you should also 
include comments that introduce each major step and explain anything that is difficult to read. 
It is important to make comments concise so that they do not crowd the program or make it 
difficult to read. 

1.7.2 Proper Spacing 

A consistent spacing style makes programs clear and easy to read, debug (find and fix errors), 
and maintain. 

A single space should he added on hoth sides of an operator, as shown in the following 
statement: 



Bad style 
Good style 


More detailed guidelines can be found in Supplement I.F, Python Coding Style Guidelines, 
on the Companion Website. 


1.8 Programming Errors 

Programming errors can be categorized into three types: syntax errors, runtime errors, 
and logic errors. 


Key 
I*"- 5 Point 


1.8.1 Syntax Errors 

The most common error you will encounter are syntax errors. Like any programming Ian- common errors 

guage. Python has its own syntax, and you need to write code that obeys the syntax rules. If syntax rules 
your program violates the rules—for example, if a quotation mark is missing or a word is 
misspelled—Python will report syntax errors. 

Syntax errors result from errors in code construction, such as mistyping a statement, incor- syntax errors 
rect indentation, omitting some necessary punctuation, or using an opening parenthesis with¬ 
out a corresponding closing parenthesis. These errors are usually easy to detect, because 
Python tells you where they are and what caused them. For example, the following print 
statement has a syntax error: 




Administrator Command Prom^ - python 


>>> printC'Trograrining is fun> 

I File "<stdin>", line 1 

print<"Progranning is fun> 

SyntaxError: EOL while scanning string literal 

I-' ' 
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The string Programming is fun should be closed with a closing quotation mark. 


Tip 

If you don’t know how to correct a syntax error, compare your program closely, charac¬ 
ter by character, with similar examples in the text. In the first few weeks of this course, 
you will probably spend a lot of time fixing syntax errors. Soon, you will be familiar with 
Python syntax and will be able to fix syntax errors quickly. 

1.8.2 Runtime Errors 

Runtime errors are errors that cause a program to terminate abnormally. They occur while a 
program is running if the Python interpreter detects an operation that is impossible to carry 
out. Input mistakes typically cause runtime errors. An input error occurs when the user 
enters a value that the program cannot handle. For instance, if the program expects to read in 
a number, but instead the user enters a string of text, this causes data-type errors to occur in 
the program. 

Another common source of runtime errors is division by zero. This happens when the divi¬ 
sor is zero for integer divisions. For example, the expression 1 / 0 in the following statement 
would cause a runtime error. 




1.8.3 Logic Errors 

Logic errors occur when a program does not perform the way it was intended to. Errors of this 
kind occur for many different reasons. For example, suppose you wrote the program in 
Listing 1.4 to convert a temperature (35 degrees) from Fahrenheit to Celsius. 

Listing I .4 ShowLogi cErrors. py 

1 # Convert Fahrenheit to Celsius 

2 pri ntC'Fahrenheit 35 is Celsius degree ") 

3 printCS / 9 * 35 - 32) 



Fahrenheit 35 is Celsius degree 
-12.555555555555554 


You will get Celsius -12.55 degrees, which is wrong. It should be 1.66. To get the correct 
result, you need to use 5 / 9 * (35 - 32) rather than 5 / 9 * 35 - 32 in the expression. 
That is, you need to add parentheses around (35 - 32) so Python will calculate that expression 
first before doing the division. 

In Python, syntax errors are actually treated like runtime errors because they are detected 
by the interpreter when the program is executed. In general, syntax and runtime errors are 
easy to find and easy to correct, because Python gives indications as to where the errors 
came from and why they are wrong. Finding logic errors, on the other hand, can be very 
challenging. 
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1.32 What are three kinds of program errors? 

1.33 If you forget to put a closing quotation mark on a string, what kind of error will be 
raised? 

1.34 If your program needs to read data from a file, but the file does not exist, an error 
would occur when running this program. What kind of error is this? 

1.35 Suppose you write a program for computing the perimeter of a rectangle and you 
mistakenly write your program so that it computes the area of a rectangle. What kind 
of error is this? 
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1.9 Getting Started with Graphics Programming 

Turtle is Python’s built-in graphics module for drawing lines, circles, and other 

shapes, including text. It is easy to learn and simple to use. ^ ? Point 

Beginners often enjoy learning programming by using graphics. For this reason, we provide a 
section on graphics programming at the end of most of the chapters in the first part of the 
book. However, these materials are not mandatory. They can be skipped or covered later. 

There are many ways to write graphics programs in Python. A simple way to start graphics 
programming is to use Python’s built-in turtl e module. Later in the book, we will introduce turtl e 
Tkinter for developing comprehensive graphical user interface applications. Tkinter 


1.9.1 Drawing and Adding Color to a Figure 

The following procedure will give you a basic introduction to using the turtl e module. Sub¬ 
sequent chapters introduce more features. 


1. Launch Python by choosing Python (command line) from the Windows Start button or 
by typing python at the command prompt. 


2. At the Python statement prompt »>, type the following command to import the turtl e 
module. This command imports all functions defined in the turtl e module and makes 
them available for you to use. 

»> import turtle # Import turtle module 

3. Type the following command to show the current location and direction of the turtle, as 
shown in Figure 1.15a. 



VideoNote 

Start with Turtle graphics 


»> turtle.showturtle() 

Graphics programming using the Python Turtle module is like drawing with a pen. The 
arrowhead indicates the current position and direction of the pen. turtle is initially 
positioned at the center of the window. Here, turtle refers to the object for drawing 
graphics (objects will be introduced in Chapter 3). 

4. Type the following command to draw a text string: 


»> turtle.writeC'Welcome to Python") 

Your window should look like the one shown in Figure L15b. 

5. Type the following command to move the arrowhead 100 pixels forward to draw a line 
in the direction the arrow is pointing: 

»> turtle.forward(lOO) 


Your window should now look like the one shown in Figure L15c. 
To draw the rest of Figure 1.15, continue with these steps. 
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(d) (e) (f) 

Figure 1.15 Graphics are dynamically displayed with each statement. 


6. Type the following commands to turn the arrowhead right 90 degrees, change the 
turtle’s color to red, and move the arrowhead 50 pixels forward to draw a line, as 
shown in Figure 1.15d: 

»> turtle. right(90) 

»> turtle.colorC'red") 

»> turtle.forward(50) 

7. Now, type the following commands to turn the arrowhead right 90 degrees, set the color to 
green, and move the arrowhead 100 pixels forward to draw a line, as shown in Figure 1.15e: 

»> turtle. right(90) 

»> turtle.colorC'green") 

»> turtle.forward(lOO) 

8. Finally, type the following commands to turn the arrowhead right 45 degrees and move 
it 80 pixels forward to draw a line, as shown in Figure 1.15f: 

»> turtl e. ri ght(45) 

»> turtle.forward(80) 

9. You can now close the Turtle Graphics window and exit Python. 

1.9.2 Moving the Pen to Any Location 

When the Turtle program starts, the arrowhead is at the center of the Python Turtle Graphics 
window at the coordinates (0, 0), as shown in Figure 1.16a. You can also use the gotoCx, y) 
command to move the turtl e to any specified point (x, y). 

Restart Python and type the following command to move the pen to (0, 50) from (0, 0), as 
shown in Figure 1.16h. 

»> import turtle 
»> turtle.goto(0, 50) 
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(a) 


' Python Turtle Graphics 
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(d) 
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(b) 



(e) 


91^ Python Turtle Graphics 
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(50, -50) 
(c) 


Figure 1.16 (a) The center of the Turtle Graphics window is at the coordinates (0, 0). (b) Move to (0, 50). (c) Move the 

pen to (50, -50). (d) Set color to red. (e) Draw a circle using the ci rcl e command. 


You can also lift the pen up or put it down to control whether to draw a line when the pen 
is moved by using the penupO and pendownC) commands. For example, the following 
commands move the pen to (50, -50), as shown in Figure 1.16c. 

»> turtle.penupO 
»> turtle.goto(50, -50) 

»> turtle.pendownC) 

You can draw a circle using the ci rcl e command. For example, the following commands 
set color red (Figure 1.16d) and draw a circle with radius 50 (Figure 1.16e). 

»> turtle.colorC'red") 

»> turtl e. ci rcl e(50) # Draw a circle with radius 50 

1.9.3 Drawing the Olympic Rings Logo 

Listing 1.5 shows a program for drawing the Olympics rings logo, as shown in Figure 1.17. 

Listing 1.5 OlympicSymbol .py 

1 import turtle 

2 

3 turtle. ColorC'blue") draw blue circle 

4 turtl e. penupO 

5 turtle. goto(-110, -25) 

6 turtle.pendownC) 

7 turtle.circl eC45) 

8 

9 turtle. colorCblack") 


draw black circle 
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draw red circle 


draw yellow circle 


draw green circle 


pause 
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Figure 1.17 The program draws the Olympics rings logo. 
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24 
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, pendownO 
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33 

tu 

rtl e. 

, doneO 



The program imports the turtle module to use the Turtle Graphics window (line 1). It 
moves the pen to (—110, —25) (line 5) and draws a blue circle with radius 45 (line 7). Similarly, 
it draws a black circle (lines 9-13), a red circle (lines 15-19), a yellow circle (lines 21-25), and 
a green circle (lines 27-31). 

Line 33 invokes turtle’s doneC) command, which causes the program to pause until the 
user closes the Python Turtle Graphics window. The purpose of this is to give the user time to 
view the graphics. Without this line, the graphics window would be closed right after the pro¬ 
gram is finished. 

1.36 How do you import the turtl e module? 

1.37 How do you display text in Turtle? 

1.38 How do you move the pen forward? 

1.39 How do you set a new color? 

1.40 How do you move the pen without drawing anything? 

1.41 How do you draw a circle? 

1.42 What is the purpose of turtle. doneC) in line 33 in Listing 1.5? 
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Key Terms 


•py file 16 
assembler 10 
assembly language 10 
bit 4 
bus 2 
byte 4 

cable modem 8 

calling a function 15 

central processing unit (CPU) 3 

comment 16 

compiler 10 

console 14 

dot pitch 8 

DSL (digital subscriber line) 8 
encoding scheme 4 
function 15 
hardware 2 
high-level language 10 
IDLE (Interactive DeveLopment 
Environment) 14 
indentation 17 
interactive mode 16 
interpreter 10 
invoking a function 15 


line comment 16 

logic error 20 

low-level language 10 

machine language 9 

memory 5 

modem 8 

module 16 

motherboard 3 

network interface card (NIC) 8 

operating system (OS) 12 

pixel 8 

program 2 

runtime errors 20 

screen resolution 8 

script file 16 

script mode 16 

software 2 

source code 10 

source file 16 

source program 10 

statement 10 

storage device 5 

syntax errors 19 

syntax rules 19 


Note 

The above terms are defined in the present chapter. Supplement I.A, Glossary, lists 
all the key terms and descriptions in the book, organized by chapters. 

Chapter Summary 

1. A computer is an electronic device that stores and processes data. 

2. A computer includes both hardware and software. 

3. Hardware is the physical aspect of the computer that can be touched. 

4. Computer programs, known as software, are the invisible instructions that control the 
hardware and make it perform tasks. 

5. Computer programming is the writing of instructions (i.e., code) for computers to 
perform. 

6 . The central processing unit (CPU) is a computer’s brain. It retrieves instructions 
from memory and executes them. 

7. Computers use zeros and ones because digital devices have two stable electrical 
states, off and on, referred to by convention as zero and one. 

8. A luf is a binary digit 0 or 1 . 


Supplement I.A 
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9. A is a sequence of 8 bits. 

10. A kilobyte is about 1,000 bytes, a megabyte about 1 million bytes, a gigabyte about 
1 billion bytes, and a terabyte about 1,000 gigabytes. 

I I. Memory stores data and program instructions for the CPU to execute. 

12. A memory unit is an ordered sequence of bytes. 

13. Memory is volatile, because information that hasn’t been saved is lost when the 
power is turned off. 

14- Programs and data are permanently stored on storage devices and are moved to 
memory when the computer actually uses them. 

15. The machine language is a set of primitive instructions built into every computer. 

16. Assembly language is a low-level programming language in which a mnemonic is 
used to represent each machine-language instruction. 

17. High-level languages are English-like and easy to learn and program. 

18. A program written in a high-level language is called source code. 

19. A compiler is a software program that translates the source program into a machine- 
language program. 

20. The operating system (OS) is a program that manages and controls a computer’s 
activities. 

21 . You can run Python on Windows, UNIX, and Mac. 

22. Python is interpreted, meaning that Python translates each statement and processes it 
one at a time. 

23. You can enter Python statements interactively from the Python statement prompt »> 
or store all your code in one file and execute it using one command. 

24. To run a Python source fde from the command line, use the tpyihon filename.tpy 
command. 

25. In Python, comments are preceded by a pound sign (#) on a line, called a line comment, 
or enclosed between triple quotation marks ( ' ' ' and ' ' ' ) on one or several lines, 
called a paragraph comment. 

26. Python source programs are case sensitive. 

27. Programming errors can be categorized into three types: syntax errors, runtime 
errors, and logic errors. Syntax and runtime errors cause a program to terminate 
abnormally. Logic errors occur when a program does not perform the way it was 
intended to. 


Test Questions 


Do test questions for this chapter online at www.cs.armstrong.edu/liang/py/test.html. 
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Note 

Solutions to even-numbered exercises in this book are on the Companion Website. 
Solutions to all exercises are on the Instructor Resource Website. The level of difficulty 
is rated easy (no star), moderate (*), hard (**), or challenging (***). 


level of difficulty 


Section 1.6 

1.1 {Display three different messages) Write a program that displays Welcome to 
Python, Welcome to Computer Science, and Programming is fun. 

1.2 (Display the same message five times) Write a program that displays Wei come to 
Python five times. 

*1.3 (Display a pattern) Write a program that displays the following pattern: 


FFFFFFF U 

U 

NN 

NN 

FF U 

U 

NNN 

NN 

FFFFFFF U 

U 

NN N 

NN 

FF U 

U 

NN N 

NN 

FF 

UUU 

NN 

NNN 

(Print a table) Write a program that displays the following table: 

a a^2 

a^3 



1 1 

1 



2 4 

8 



3 9 

27 



4 16 

64 




1.5 (Compute expressions) Write a program that displays the result of 

9.5 X 4.5 - 2.5 X 3 
45.5 - 3.5 

1.6 (Summation of a series) Write a program that displays the result of 1 -f 2 + 
3 + 4-h5 + 6 + 74-8 + 9. 


1.7 (Approximate tt) tt can be computed using the following formula: 


77 = 4 X 


11111 

— — — - 

3 5 7 9 11 


Write a program that displays the result of 4 X 


1111 1 \ 

-h--h-- 1. 

3 5 7 9 liy 


and 4 X 


11111 1 1 A 

__l_____l___ — -|_ — _ — 1 

3 5 7 9 11 13 15/ 


1.8 (Area and perimeter of a circle) Write a program that displays the area and 
perimeter of a circle that has a radius of 5.5 using the following formulas: 


area = radius X radius X tt 
perimeter = 2 X radius X tt 
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1.9 (Area and perimeter of a rectangle) Write a program that displays the area and 
perimeter of a rectangle with the width of 4.5 and height of 7.9 using the follow¬ 
ing formula: 

area = width X height 

1.10 (Average speed) Assume a runner runs 14 kilometers in 45 minutes and 30 sec¬ 
onds. Write a program that displays the average speed in miles per hour. (Note that 
1 mile is 1.6 kilometers.) 

*1.11 (Population projection) The US Census Bureau projects population based on the 
following assumptions: 

One birth every 7 seconds 

One death every 13 seconds 

One new immigrant every 45 seconds 

Write a program to display the population for each of the next five years. Assume the 
current population is 312032486 and one year has 365 days. Hint: in Python, you 
can use integer division operator // to perform division. The result is an integer. For 
example, 5 // 4 is 1 (not 1.25) and 10 // 4 is 2 (not 2. 5). 

Section 1.9 

1.12 (Turtle: draw four squares) Write a program that draws four squares in the center 
of the screen, as shown in Figure 1.18a. 
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Figure 1.18 Four squares are drawn in (a), a cross is drawn in (b), a triangle is drawn in (c), and two triangles are drawn 
in (d). 


1.13 (Turtle: draw a cross) Write a program that draws a cross as shown in Figure 1.18b. 

1.14 (Turtle: draw a triangle) Write a program that draws a triangle as shown in 
Figure 1.18c. 

1.15 (Turtle: draw two triangles) Write a program that draws two triangles as shown in 
Figure 1.18d. 

1.16 (Turtle: draw four circles) Write a program that draws four circles in the center of 
the screen, as shown in Figure 1.19a. 

I. I 7 (Turtle: draw a line) Write a program that draws a red line connecting two points 
(-39, 48) and (50, -50) and displays the coordinates of the two points, as shown 
in Figure 1.19b. 

**I.I8 (Turtle: draw a star) Write a program that draws a star, as shown in Figure 1.19c. 
(Hint: The inner angle of each point in the star is 36 degrees.) 
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(a) (b) (c) 

Figure 1.19 Four circles are drawn in (a), a line is drawn in (b), and a star is drawn in (c). 


1. 19 {Turtle: draw a polygon) Write a program that draws a polygon that connects the 
points (40, -69.28), (-40, -69.28), (-80, -9.8), (-40, 69), (40, 69), and (80, 
0) in this order, as shown in Figure 1.20a. 



Figure 1.20 (a) The program displays a polygon, (b) The program displays a rectanguloid. (c) The program displays a 

clock for the time. 


1.20 {Turtle: display a rectanguloid) Write a program that displays a rectanguloid, as 
shown in Figure 1.20b. 

* 1.2 I {Turtle: display a clock) Write a program that displays a clock to show the time 
9:15:00, as shown in Figure 1.20c. 
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CHAPTER 


2 

Elementary 

Programming 

objectives 

■ To write programs that perform simple computations (§2.2). 

■ To obtain input from a program’s user by using the Input function (§2.3). 

■ To use identifiers to name elements such as variables and functions (§2.4). 

■ To assign data to variables (§2.5). 

■ To perform simultaneous assignment (§2.6). 

■ To define named constants (§2.7). 

■ To use the operators and ** (§2.8). 

■ To write and evaluate numeric expressions (§2.9). 

■ To use augmented assignment operators to simplify coding (§2.10). 

■ To perform numeric type conversion and rounding with 
the int and round functions (§2.11). 

■ To obtain the current system time by using time. time() (§2.12). 

■ To describe the software development process and apply it to develop 
a loan payment program (§2.13). 

■ To compute and display the distance between two points in graphics (§2.14). 
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2.1 Introduction 

The focus of this chapter is on learning elementary programming techniques to solve 
problems. 

In Chapter 1 you learned how to create and run very basic Python programs. Now you will 
learn how to solve problems by writing programs. Through these problems, you will learn 
fundamental programming techniques, such as the use of variables, operators, expressions, 
and input and output. 

Suppose, for example, that you need to take out a student loan. Given the loan amount, 
loan term, and annual interest rate, can you write a program to compute the monthly payment 
and total payment? This chapter shows you how to write programs like this. Along the way, 
you learn the basic steps that go into analyzing a problem, designing a solution, and imple¬ 
menting the solution by creating a program. 


2.2 Writing a Simple Program 

Writing a program involves designing a strategy for solving the problem and then 
using a programming language to implement that strategy. 

problem 

Let’s first consider the simple problem of computing the area of a circle. How do we write a 
program for solving this problem? 

Writing a program involves designing algorithms and then translating them into program¬ 
ming instructions, or code. When you code —that is, when you write a program—you translate 

algorithm 

an algorithm into a program. An algorithm describes how a problem is solved by listing the 
actions that need to be taken and the order of their execution. Algorithms can help the 
programmer plan a program before writing it in a programming language. Algorithms can be 

pseudocode 

described in natural languages or in pseudocode (natural language mixed with some program¬ 
ming code). The algorithm for calculating the area of a circle can be described as follows: 

1. Get the circle’s radius from the user. 

2. Compute the area by applying the following formula: 

area = radius X radius X tt 

3. Display the result. 

variable 

It's always good practice to outline your program (or its underlying problem) in the form 
of an algorithm before you begin coding. 

In this problem, the program needs to read the radius, which the program’s user enters 
from the keyboard. This raises two important issues: 

■ Reading the radius. 

■ Storing the radius in the program. 

Let’s address the second issue first. The value for the radius is stored in the computer’s 
memory. In order to access it, the program needs to use a variable. A variable is a name 
that references a value stored in the computer’s memory. Rather than using x and y as 

descriptive names 

variable names, choose descriptive names: in this case, for example, you can use the name 
radius for the variable that references a value for radius and area for the variable that 
references a value for area. 

The first step is to prompt the user to designate the circle’s radius. You will learn how to 
prompt the user for information shortly. For now, to learn how variables work, you can assign 
a fixed value to radius in the program as you write the code. 
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The second step is to compute area by assigning the result of the expression radius * 
radius * 3.14159 to area. 

In the final step, the program will display the value of area on the console by using 
Python’s print function. 

The complete program is shown in Listing 2.1. 

Listing 2.1 ComputeArea. py 

1 # Assign a value to radius 

2 radius = 20 # radius is now 20 

3 

4 # Compute area 

5 area = radius * radius * 3.14159 

6 

7 # Display results 

8 printC'The area for the circle of radius", radius, 'is' , area) 


radius —► 20 


area 1256.636 


The area for the circle of radius 20 is 1256.636 


Variables such as radius and area reference values stored in memory. Every variable has 
a name that refers to a value. You can assign a value to a variable using the syntax as shown 
in line 2. 

radius = 20 

This statement assigns 20 to the variable radius. So now radius references the value 
20. The statement in line 5 

area = radius * radius * 3.14159 

uses the value in radius to compute the expression and assigns the result into the variable 
area. The following table shows the value for radius and area as the program is executed. 
Each row in the table shows the values of variables after the statement in the corresponding 
line in the program is executed. This method of reviewing how a program works is called 
tracing a program. Tracing programs are helpful for understanding how programs work, and 
they are useful tools for finding errors in programs. 


line# 

radius 

area 

2 

20 


5 


1256.636 


If you have programmed in other languages, such as Java, you know you have to declare a 
variable with a data type to specify what type of values are being used, such as integers or text 
characters. You don’t do this in Python, however, because Python automatically figures out 
the data type according to the value assigned to the variable. 

The statement in line 8 displays four items on the console. You can display any number of 
items in a print statement using the following syntax: 


display result 



assign value 


trace a program 




data type 


printCiteml, item2, ..., itemk) 


pri nt(t teml, . . .) 
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eval function 


input radi us 


compute area 


display result 



If an item is a number, the number is automatically converted to a string for displaying. 

2.1 Show the printout of the following code: 
width = 5.5 

height = 2 

printC'area is' , width * height) 

2.2 Translate the following algorithm into Python code: 

■ Step 1: Use a variable named miles with initial value 100. 

■ Step 2: Multiply miles by 1.609 and assign it to a variable named ki 1 ometers. 

■ Step 3: Display the value of kilometers. 

What is kilometers after Step 3? 

2.3 Reading Input from the Console 

Reading input from the console enables the program to accept input from the user. 

In Listing 2.1, a radius is set in the source code. To use a different radius, you have to modify 
the source code. You can use the i nput function to ask the user to input a value for the radius. 
The following statement prompts the user to enter a value, and then it assigns the value to the 
variable: 

variable = inputC'Enter a value: ") 

The value entered is a string. You can use the function eval to evaluate and convert it to a 
numeric value. For example, eval ("34.5") returns 34.5, eval ("345") returns 345, 
eval ("3 + 4") returns 7, and eval ("51 + (54 * (3 + 2))") returns 321. 

Listing 2.2 rewrites Listing 2.1 to prompt the user to enter a radius. 

Listing 2.2 ComputeAreaWi thConsol einput. py 

1 # Prompt the user to enter a radius 

2 radius = eval(input( 'Enter a value for radius: ' )) 

3 

4 # Compute area 

5 area = radius * radius * 3.14159 

6 

7 # Display results 

8 printC'The area for the circle of radius", radius, 'is", area) 


Enter a value for radius: 2.5 j2 


The area for the circle of radius 2.5 is 19.6349375 


Enter a value for radius: 23 Enter| 

The area for the circle of radius 23 is 1661.90111 


Line 2 prompts the user to enter a value (in the form of a string) and converts it to a num¬ 
ber, which is equivalent to 

s = inputC'Enter a value for radius: ") # Read input as a string 

radius = eval(s) # Convert the string to a number 

After the user enters a number and presses the Enter key, the number is read and assigned 

to radius. 
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Listing 2.2 shows how to prompt the user for a single input. However, you can prompt for 
multiple inputs as well. Listing 2.3 gives an example of reading multiple inputs from the key¬ 
board. This program reads three integers and displays their average. 


Listing 2.3 Compu teAverage. py 

1 # Prompt the user to enter three numbers 

2 numberl = eval(i nput("Enter the first number: ")) 

3 numberZ = eval(i nput("Enter the second number: )) 

4 numbers = eval(i nputC'Enter the third number: 

5 

6 # Compute average 

7 average = (numberl + number2 + numbers) / 3 

8 

9 # Display result 

10 printC'The average of", numberl, number2, numbers, 

11 "is", average) 


Enter the first number: 1 
Enter the second number: 2 
Enter the third number: 3 
The average ofl 2 3is2.0 


The program prompts the user to enter three integers (lines 2-^), computes their average 
(line 7), and displays the result (lines 10-11). 

If the user enters something other than a number, the program will terminate with a runtime 
error. In Chapter 13, you will learn how to handle the error so that the program can continue to run. 

Normally a statement ends at the end of the line. In the preceding listing, the print state¬ 
ment is split into two lines (lines 10-11). This is okay, because Python scans the print state¬ 
ment in line 10 and knows it is not finished until it finds the closing parenthesis in line 11. We 
say that these two lines are joined implicitly. 



In some cases, the Python interpreter cannot determine the end of the statement 
written in multiple lines. You can place the line continuation symbol (\) at the end 
of a line to tell the interpreter that the statement is continued on the next line. For 
example, the following statement 

sum =l+2+3+4+\ 

5 + 6 

is equivalent to 

sum =l+2+3+4+5+6 


Note 

Most of the programs in early chapters of this book perform three steps: Input, Process, 
and Output, called IPO. Input is to receive input from the user. Process is to produce 
results using the input. Output is to display the results. 

2.3 How do you write a statement to prompt the user to enter a numeric value? 

2.4 What happens if the user enters 5a when executing the following code? 
radius = eval(i nput("Enter a radius: ")) 

How do you break a long statement into multiple lines? 



input numberl 
input number2 
input numbers 



runtime error 


joining lines explicitly 


line continuation symbol 


split a long statement 


IPO 
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2.4 Identifiers 

Identifiers are the names that identify the elements such as variables and functions in a 
program. 


As you can see in Listing 2.3, numberl, numberZ, numbers, average, input, eval, and 
print are the names of things that appear in the program. In programming terminology, such 
names are called identifiers. All identifiers must obey the following rules: 


identifier naming rules 


keyword 
reserved word 


■ An identifier is a sequence of characters that consists of letters, digits, and 
underscores ( ). 

■ An identifier must start with a letter or an underscore. It cannot start with a digit. 

■ An identifier cannot be a keyword. (See Appendix A, Python Keywords, for a list of 
keywords.) Keywords, also called reserved words, have special meanings in Python. 
For example, import is a keyword, which tells the Python interpreter to import a 
module to the program. 

■ An identifier can be of any length. 


For example, area, radius, and number 1 are legal identifiers, whereas 2A and d+4 are 
not because they do not follow the rules. When Python detects an illegal identifier, it reports a 
syntax error and terminates the program. 


case sensitive 



Note 

Because Python is case sensitive, area. Area, and AREA are all different identifiers. 


descriptive names 



Tip 

Descriptive identifiers make programs easy to read. Avoid using abbreviations for identi¬ 
fiers. Using complete words is more descriptive. For example, numberOfStudents is 
better than numStuds, numOfStuds, or numOfStudents. We use descriptive 
names for complete programs in the text. However, we will occasionally use variables 
names such as ■, j, k, x, and y in the code snippets for brevity. These names also 
provide a generic tone to the code snippets. 


variable naming convention 


camelCase 



Tip 

Use lowercase letters for variable names, as in radius and ares. If a name consists of 
several words, concatenate them into one, making the first word lowercase and capital¬ 
izing the first letter of each subsequent word—for example, numberOfStudents. 
This naming style is known as the camelCase because the uppercase characters in the 
name resemble a camel’s humps. 
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2.6 Which of the following identifiers are valid? Which are Python keywords (see 
Appendix A)? 

miles, Test, a-i-b, b-a, 4#R, $4, #44, apps 
if, el if, X, y, radius 


tr/Key 
tp ? Point 

why called variables? 


2.5 Variables, Assignment Statements, and Expressions 

Variables are used to reference values that may be changed in the program. 

As you can see from the programs in the preceding sections, variables are the names that refer¬ 
ence values stored in memory. They are called “variables” because they may reference different 
values. For example, in the following code, radi us is initially 1 . 0 (line 2) and then changed to 
2 . 0 (line 7), and area is set to 3.14159 (line 3) and then reset to 12.56636 (line 8). 
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1 # Compute the first area 

2 radius = 1.0 radius — |1.0 | 

3 area = radius * radius * 3.14159 area —>> 13.141591 

4 printC'The area is", area, "for radius", radius) 

5 

6 # Compute the second area 

7 radius = 2.0 radius —>> |2.0 ] 

8 area = radius * radius * 3.14159 area —► 112.566361 

9 printC'The area is", area, "for radius", radius) 

The statement for assigning a value to a variable is called an assignment statement. In 
Python, the equal sign (=) is used as the assignment operator. The syntax for assignment state¬ 
ments is as follows; 

variable = expression 

An expression represents a computation involving values, variables, and operators that, 
taken together, evaluate to a value. For example, consider the following code: 

y = 1 # Assign 1 to variable y 

radius = 1.0 # Assign 1.0 to variable radius 

x=5*(3/2)+3*2 # Assign the value of the expression to x 

X = y + 1 # Assign the addition of y and 1 to x 

area = radius * radius * 3.14159 # Compute area 

You can use a variable in an expression. A variable can also be used in both sides of the = 
operator. For example, 

X = X + 1 

In this assignment statement, the result of x + 1 is assigned to x. If x is 1 before the state¬ 
ment is executed, then it becomes 2 after the statement is executed. 

To assign a value to a variable, you must place the variable name to the left of the assign¬ 
ment operator. Thus, the following statement is wrong: 

1 = X # Wrong 

Note 

In mathematics, x = 2 * x + 1 denotes an equation. However, in Python, x = 2 * 

X + 1 is an assignment statement that evaluates the expression 2 * x + 1 and assigns 
the result to x. 

If a value is assigned to multiple variables, you can use a syntax like this: 

i = j = k = 1 

which is equivalent to 

k = 1 
j = k 
T = j 

Every variable has a scope. The scope of a variable is the part of the program where the 
variable can be referenced. The rules that define the scope of a variable will be introduced 
gradually later in the book. For now, all you need to know is that a variable must be created 
before it can be used. For example, the following code is wrong: 
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e 


simultaneous assignment 






count IS not defined 


yet. 


»> count = count + 1 
NameError: count is not defined 

»> 


To fix it, you may write the code like this: 


»> count = 1 # count is not created 

»> count = count + 1 # Now increment count 

»> 


Caution 

A variable must be assigned a value before it can be used in an expression. For example, 

interestRate = 0.05 
interest = interestrate * 45 

This code is wrong, because interestRate is assigned a value 0.05, but 
interestrate is not defined. Python is case-sensitive. interestRate and 
interestrate are two different variables. 

2.6 Simultaneous Assignments 

Python also supports simultaneous assignment in syntax like this: 
varl, var2, ..., varn = expl, exp2, ..., expn 

It tells Python to evaluate all the expressions on the right and assign them to the corre¬ 
sponding variable on the left simultaneously. Swapping variable values is a common opera¬ 
tion in programming and simultaneous assignment is very useful to perform this operation. 
Consider two variables: x and y. How do you write the code to swap their values? A common 
approach is to introduce a temporary variable as follows: 



»> 

X = 1 





»> 

y = 2 





A 

A 

A 

temp = X 

# 

Save X 

in a temp 

vari abl e 

»> 

X = y 

# 

Assign 

the value 

in y to X 

»> 

y = temp 

# 

Assign 

the value 

in temp to y 


But you can simplify the task using the following statement to swap the values of x and y. 


»> X, y = y, X # Swap x with y 


Simultaneous assignment can also be used to obtain multiple input in one statement. 
Listing 2.3 gives an example that prompts the user to enter three numbers and obtains their 
average. This program can be simplified using a simultaneous assignment statement, as 
shown in Listing 2.4. 
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Listing 2.4 ComputeAverageWi thSi mul taneousAssi gnment. py 

1 # Prompt the user to enter three numbers 

2 numberl, number2, numbers = eval(input( input numbers 

3 'Enter three numbers separated by commas; ")) 

4 

5 # Compute average 

6 average = (numberl + number2 + numbers) / 3 

7 

8 # Display result 

9 printC'The average of", numberl, number2, numbers 

10 "is", average) 


Enter three numbers separated by commas: 1, 2, 3 [ —I Enter 
The average ofl 2 3is2.0 



enter input in one line 


2.7 What is the naming convention for variables? 

2.8 What is wrong in the following statement? 

2 = a 

2.9 What is x, y, and z after the following statement? 

X = y = z = 0 

2.10 Assume that a = 1 and b = 2. What is a and b after the following statement? 
a, b = b, a 
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W Point 

MyProgrammingLab" 


2.7 Named Constants 

A named constant is an identifier that represents a permanent value. 

The value of a variable may change during the execution of a program, but a named constant 
(or simply constant) represents permanent data that never changes. In our ComputeArea 
program, 77 is a constant. If you use it frequently, you don’t want to keep typing 3.14159; constant naming convention 
instead, you can use a descriptive name PI for the value. Python does not have a special 
syntax for naming constants. You can simply create a variable to denote a constant. However, 
to distinguish a constant from a variable, use all uppercase letters to name a constant. For 
example, you can rewrite Listing 2.1 to use a named constant for tt, as follows: 

# Assign a radius 

radius = 20 # radius is now 20 

# Compute area 

PI = 3.14159 

area = radius * radius * PI 

# Display results 

printC'The area for the circle of radius", radius, "is", area) 

There are three benefits of using constants: benefits of constants 

1. You don’t have to repeatedly type the same value if it is used multiple times. 

2. If you have to change the constant’s value (e.g., from 3.14 to 3.14159 for PI), you 
need to change it only in a single location in the source code. 

3. Descriptive names make the program easy to read. 


Key 

Point 
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2.8 Numeric Data Types and Operators 

Python has two numeric types—integers and floating-point numbers— -for working 
with the operators +, *, /, //, **, and %. 


floating-point numbers 

integer 

int 

float 



VideoNote 

Perform computation 

literal 

operands 

operators +, *, /, //, **, % 


The information stored in a computer is generally referred to as data. There are two types 
of numeric data: integers and real numbers. Integer types (int for short) are for represent¬ 
ing whole numbers. Real types are for representing numbers with a fractional part. Inside 
the computer, these two types of data are stored differently. Real numbers are represented 
as floating-point {ot float) values. How do we tell Python whether a number is an integer 
or a float? A number that has a decimal point is a float even if its fractional part is 0. For 
example, 1.0 is a float, but 1 is an integer. These two numbers are stored differently in the 
computer. In the programming terminology, numbers such as 1.0 and 1 are called literals. A 
literal is a constant value that appears directly in a program. 

The operators for numeric data types include the standard arithmetic operators, as shown 
in Table 2.1. The operands are the values operated by an operator. 


Table 2.1 Numeric Operators 

Name Meaning Example Result 


+ 

Addition 

34 + 1 

35 

- 

Subtraction 

34.0 - 0.1 

33.9 


Multiplication 

300 * 30 

9000 

/ 

Float Division 

1 / 2 

0.5 

// 

Integer Division 

1 // 2 

0 


Exponentiation 

4 ** 0.5 

2.0 

% 

Remainder 

20 % 3 

2 


The -H, -, and * operators are straightforward, but note that the -h and operators can be 
unary operator both unary and binary. A unary operator has only one operand; a binary operator has two. For 

binary operator example, the operator in - 5 is a unary operator to negate the number 5, whereas the oper¬ 

ator in 4 - 5 is a binary operator for subtracting 5 from 4. 


/ operator 


2.8.1 The /, //, and ** Operators 

The / operator performs a float division that results in a floating number. For example, 



»> 4 / 2 

2.0 

»> 2 / 4 
0.5 
»> 


// operator 


The // operator performs an integer division; the result is an integer, and any fractional 
part is truncated. For example, 


»> 5 // 2 
2 

»> 2 // 4 
0 

»> 
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To compute (a with an exponent of b) for any numbers a and b, you can write a ** b 
in Python. For example. 


»> 2.3 3.5 

18.45216910555504 
»> (-2.5) 2 

6.25 
»> 


2.8.2 The % Operator 

The % operator, known as remainder or modulo operator, yields the remainder after division. 
The left-side operand is the dividend and the right-side operand is the divisor. Therefore, 7 % 
3 yields 1, 3 % 7 yields 3,12 % 4 yields 0, 26 % 8 yields 2, and 20 % 13 yields 7. 


2 0 


3 3 


1 -«-Quotient 




Divisor 



Dividend 


Remainder 


The remainder operator is very useful in programming. For example, an even number % 2 
is always 0 and an odd number % 2 is always 1. Thus, you can use this property to determine 
whether a number is even or odd. If today is Saturday, it will be Saturday again in 7 days. Sup¬ 
pose you and your friends are going to meet in 10 days. What day is in 10 days? You can find 
that the day is Tuesday using the following expression: 


Day 6 in a week is Saturday 



After 10 days 


A week has 7 days 


Day 2 in a week is Tuesday 
Note: Day 0 in a week is Sunday 


Listing 2.5 shows a program that obtains minutes and remaining seconds from an amount 
of time in seconds. For example, 500 seconds contains 8 minutes and 20 seconds. 

Listing 2.5 DisplayTime.py 

1 # Prompt the user for input 

2 seconds = evai(i nput("Enter an integer for seconds: ")) 

3 

4 # Get minutes and remaining seconds 

5 minutes = seconds // 60 # Find minutes in seconds 

6 remainingSeconds = seconds % 60 # Seconds remaining 

7 print(seconds, "seconds is", minutes, 

8 "minutes and", remainingSeconds, "seconds") 


Enter an integer for seconds: 500 I .-J Ente^ 
500 seconds is 8 minutes and 20 seconds 


** exponent operator 



% operator 


input seconds 


get mi nutes 

get remai ni ngSeconds 
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Line 2 reads an integer for seconds. Line 5 obtains the minutes using seconds // 60. Line 
6 (seconds % 60) obtains the remaining seconds after taking away the minutes. 

2.8.3 Scientific Notation 

scientific notation Floating-point values can be written in scientific notation in the form of a X 10*’. For example, 

the scientific notation for 123.456 is 1.23456 X 10" and for 0.0123456 is 1.23456 X 10^^. 
Python uses a special syntax to write scientific notation numbers. For example, 1.23456 X 10^ 
is written as 1.23456E2 or 1.23456E+2, and 1.23456 X 10^^ as 1.23456E-2. The letter E 
(or e) represents an exponent and can be in either lowercase or uppercase. 


line# 

seconds 

minutes 

remain!ngSeconds 

2 

500 



5 


8 


6 



20 


why called floating point? 



Note 

The float type is used to represent numbers with a decimal point. Why are they called 
floating-point numbers? These numbers are stored in scientific notation in memory. 
When a number such as 50.534 is converted into scientific notation, such as 
5.0534E+1, its decimal point is moved (floated) to a new position. 


what is overflow? 



Caution 

When a variable is assigned a value that is too large (in size) to be stored in memory, it 
causes overflow. For example, executing the following statement causes overflow. 



»> 245.0 ** 1000 

OverflowError: 'Result too large' 

»> 


what is underflow? 


When a floating-point number is too small (that is, too close to zero), it causes 
underflow and Python approximates it to zero. Therefore, usually you don’t need to be 
concerned with underflow. 
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2.1 I What are the results of the following expressions? 


Expression 


Result 


42 / 5 
42 // 5 
42 % 5 
40 % 5 
1 % 2 
2 % 1 
45 + 4 
45 + 43 % 5 
5 ** 2 
5.1 ** 


*4-2 


(23 * 3 % 2) 


2 
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2.12 If today is Tuesday, what day of the week will it be in 100 days? 

2.13 What is the result of 25 / 4? How would you rewrite the expression if you wished 
the result to be an integer number? 


2.9 Evaluating Expressions and Operator Precedence 

Python expressions are evaluated in the same way as arithmetic expressions. 

Writing a numeric expression in Python involves a straightforward translation of an arith¬ 
metic expression using operators. For example, the arithmetic expression 

3 + 4jc 10(y - 5)(a ^ c) ^ f A ^ 9 + x\ 

5 X \x y ) 

can be translated into a Python expression as: 

(3 + 4*x)/5-10*(y-5)*(a + b-i-c)/x + 

9 * (4 / X + (9 + x) / y) 

Though Python has its own way to evaluate an expression behind the scene, the results of evaluate an expression 
a Python expression and its corresponding arithmetic expression are the same. Therefore, 
you can safely apply the arithmetic rules for evaluating a Python expression. Operators con¬ 
tained within pairs of parentheses are evaluated first. Parentheses can be nested, in which 
case the expression in the inner parentheses is evaluated first. When more than one operator 

is used in an expression, the following operator precedence rule is used to determine the operator precedence rule 
order of evaluation. 

■ Exponentiation (**) is applied first. 

■ Multiplication (*), float division (/), integer division (//) , and remainder operators 
(%) are applied next. If an expression contains several multiplication, division, and 
remainder operators, they are applied from left to right. 

■ Addition (-(-) and subtraction (-) operators are applied last. If an expression 
contains several addition and subtraction operators, they are applied from left 
to right. 

Here is an example of how an expression is evaluated: 


^/Key 
•P? Point 


3 + 4 " 4 + 5 * (4 + 3) - 1 

t_ 

3 + 4*4 + 5*7-l 


3 -h 16 + 5 * 7 - 1 


3 -h 16 + 35 - 1 

t_ 

19 -H 35 - 1 

E_ 

54-1 

t_ 


(1) inside parentheses first 

(2) multiplication 

(3) multiplication 

(4) addition 

(5) addition 


53 


(6) subtraction 
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iCheck 
W Point 

MyProgrammingLab" 


r~/Key 
>P / Point 


augmented assignment 
compound assignment 


addition assignment operator 


^iCheck 
\r Point 

MyProgrammingLab' 


2.14 How would you write the following arithmetic expression in Python? 


4 

3(r + 34) 


— 9(a + be) + 


3 + d{2 + a) 
a + bd 


2.15 Suppose m and r are integers. Write a Python expression for mr^. 


2.10 Augmented Assignment Operators 

The operators +, *, /, //, %, and ** can be combined with the assignment operator 

(=) to form augmented assignment operators. 

Very often the current value of a variable is used, modified, and then reassigned back 
to the same variable. For example, the following statement increases the variable count 
by 1 : 

count = count + 1 

Python allows you to combine assignment and addition operators using an augmented 
(or compound) assignment operator. For instance, the preceding statement can be written 
as: 


count += 1 

The += operator is called the addition assignment operator. All augmented assignment 
operators are shown in Table 2.2. 


Table 2.2 Augmented Assignment Operators 


Operator Name Example Equivalent 


+= 

Addition assignment 

i 

+= 8 

i 

= i 

+ 8 

-= 

Subtraction assignment 

i 

-= 8 

i 

= i 

- 8 

*= 

Multiplication assignment 

i 

*= 8 

i 

= i 

* 8 

/= 

Float division assignment 

i 

/= 8 

i 

= i 

/ 8 

//= 

Integer division assignment 

i 

//= 8 

i 

= i 

// 8 

%= 

Remainder assignment 

i 

%= 8 

i 

= i 

% 8 


Exponent assignment 

i 

**= 8 

i 

= i 

** 8 



Caution 

There are no spaces in the augmented assignment operators. For example, + = should be +=. 


2.16 Assume that a = 1, and that each expression is independent. What are the results of 
the following expressions? 


+= 4 
-= 4 
*= 4 
!= 4 
//= 4 
%= 4 
= 56 " 


a + 6 
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2.11 Type Conversions and Rounding 

If one of the operands for the numeric operators is afloat value, the result will be a 
float value. 


r; Point 


Can you perform binary operations with two operands of different types? Yes. If an integer 
and a float are involved in a binary operation, Python automatically converts the integer to a 
float value. This is called fy/7e conversion. So, 3 * 4.5 is the same as 3.0 * 4.5. type conversion 

Sometimes, it is desirable to obtain the integer part of a fractional number. You can use the 
i nt (val ue) function to return the integer part of a float value. For example, i nt function 


»> value = 5.6 
»> int(value) 

5 

»> 


Note that the fractional part of the number is truncated, not rounded up. 

You can also use the round function to round a number to the nearest whole value. For round function 
example, 


»> value = 5.6 
»> round (value) 
6 

»> 


We will discuss the round function more in Chapter 3. 

^^^Note 

The functions int and round do not change the variable being converted. For exam¬ 
ple, value is not changed after invoking the function in the following code: 


>» value = 5.6 
>» round(value) 
6 

»> value 
5.6 
»> 



Note 

The int function can also be used to convert an integer string into an integer. For 
example, int("34") returns 34. So you can use the eval or int function to 
convert a string into an integer. Which one is better? The i nt function performs a sim¬ 
ple conversion. It does not work for a non-integer string. For example, int ("3.4") 

will cause an error. The eval function does more than a simple conversion. It can be int vs. eval functions 

used to evaluate an expression. For example, eval ("3 + 4") returns 7. However, 
there is a subtle “gotcha” for using the eval function. The eval function will pro¬ 
duce an error for a numeric string that contains leading zeros. In contrast, the int 
function works fine for this case. For example, eval ("003") causes an error, but 
int("003") returns 3. 
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Listing 2.6 shows a program that displays the sales tax with two digits after the decimal point. 

input purchaseAmount 

Listing 2.6 SalesTax.py 

1 # Prompt the user for input 

2 purchaseAmount = eval(i nput("Enter purchase amount: )) 

3 

compute tax 

4 # Compute sales tax 

5 tax = purchaseAmount * 0.06 

6 

format 

7 # Display tax amount with two digits after decimal point 

8 printC'Sales tax is"_ intftax * 100) / 100.0) 


Enter purchase amount: 197.55 Enter| 

Sales tax is 11.85 

Os. 

line# purchaseAmount tax output 

2 197.55 

5 11.853 

8 11.85 

format numbers 

The value of the variable purchaseAmount is 197.55 (line 2). The sales tax is 6% of the 
purchase, so the tax is evaluated as 11.853 (line 5). Note that 

tax * 100 is 1185.3 

intCtax * 100) is 1185 

intftax * 100) / 100.0 is 11.85 

/Check 
{. Point 

MyProgrammingLab" 

So, the statement in line 8 displays the tax 11.85 with two digits after the decimal point. 

2.17 What does a conversion from a float to an integer do with the fractional part of the 
float value? Does the i nt Cval ue) function change the variable val ue? 

2.18 Are the following statements correct? If so, show their printout, 
value = 4.6 

print(int(val ue)) 

print(round(val ue)) 

print(eval ("4 * 5 + 2")) 

print(int("04")) 

print(int("4.5")) 

print(eval ("04")) 

V ^ Point 

2.12 Case Study: Displaying the Current Time 

You can use the timeC) function in the time module to obtain the current system time. 

The problem is to develop a program that displays the current time in Greenwich Mean Time 
(GMT) in the format hour:minute:second, such as 13:19:18. 

The timeC) function in the time module returns the current time in seconds with 

UNIX epoch 

millisecond precision elapsed since the time 00:00:00 on January 1, 1970 GMT, as shown 
in Figure 2.1. This time is known as the UNIX epoch. The epoch is the point when time 
starts. 1970 was the year when the UNIX operating system was formally introduced. For 
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j Flapsed ^ 

time 






Time 


UNIX epoch 
01-01-1970 
00:00:00 GMT 


Current Time 
time.time () 


Figure 2.1 The time. time() function returns the seconds with millisecond precision 
since the UNIX epoch. 


example, time.timeC) returns 128S543663.20S, which means 128S543663 seconds and 
205 milliseconds. 

You can use this function to obtain the current time, and then compute the current second, 
minute, and hour as follows. 

1. Obtain the current time (since midnight, January 1, 1970) by invoking time.timeC) 
(for example, 1203183068.328). 

2. Obtain the total seconds total Seconds using the i nt function (i nt (1203183068.328) 

= 1203183068). 

3. Compute the current second from total Seconds % 60 (1203183068 seconds % 
60 = 8, which is the current second). 

4. Obtain the total minutes total Minutes by dividing total Seconds by 60 (1203183068 

seconds// 60 = 20053051 minutes). 

5. Compute the current minute from total Minutes % 60 (20053051 minutes % 60 = 31, 
which is the current minute). 

6. Obtain the total hours total Hours by dividing total Minutes by 60 (20053051 
minutes// 60 = 334217 hours). 

7. Compute the current hour from total Hours % 24 (334217 hours % 24 = 17, which 
is the current hour). 

Listing 2.7 gives the complete program. 

Listing 2.7 ShowCurrentTime.py 

1 import time 

2 

3 currentTime = time.timeC) # Get current time 

4 

5 # Obtain the total seconds since midnight, Jan 1, 1970 

6 totalSeconds = int(currentTime) 

7 

8 # Get the current second 

9 currentSecond = totalSeconds % 60 
10 

11 # Obtain the total minutes 

12 total Minutes = totalSeconds // 60 

13 

14 # Compute the current minute in the hour 

15 currentMinute = totalMinutes % 60 

16 

17 # Obtain the total hours 

18 total Hours = totalMinutes // 60 

19 

20 # Compute the current hour 

21 currentHour = totalHours % 24 


ti me. ti me () 


import time module 
currentTime 

total Seconds 

currentSecond 

total Minutes 

currentMinute 

total Hours 

currentHour 
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display output 


22 

23 # Display results 

24 pri ntC'Current time is”, currentHour, 

25 currentMinute, currentSecond, "GMT”) 



Current time is 17:31:8 GMT 


Os. 



Line 3 invokes time.timeO to return the current time in seconds as a float value with 
millisecond precision. The seconds, minutes, and hours are extracted from the current time using 
the // and % operators (lines 6-21). 

In the sample run, a single digit 8 is displayed for the second. The desirable output would 
be 08. This can be fixed by using a function that formats a single digit with a prefix (see 
Exercise 6.48). 


iCheck 
w Point 

MyProgrammingLab” 


2.19 What is the UNIX epoch? 

2.20 What does time. time() return? 

2.21 How do you obtain the seconds from the returned value for time, time()? 


^/Key 
U /'Point 


2.13 Software Development Process 

The software development life cycle is a multistage process that includes requirements 
specification, analysis, design, implementation, testing, deployment, and maintenance. 


Developing a software product is an engineering process. Software products, no matter 
how large or how small, have the same life cycle: requirements specification, system 
analysis, system design, implementation, testing, deployment, and maintenance, as shown 
in Figure 2.2. 

requirements specification Requirements specification is a formal process that seeks to understand the problem that 

the software will address and to document in detail what the software system needs to do. 
This phase involves close interaction between users and developers. Most of the examples in 
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Requirements ■ 
Specification 


'-System Analysis 


di 


System 

Design 

"T 


Input, Process, Output 
IPO 


n 


!-Implementation 


entation - 1 

r-n . 


Testing 


n 


Deployment | - 1 

\ 


— Maintenance 


Figure 2.2 At any stage of the software development life cycle, it may be necessary to go 
back to a previous stage to correct errors or deal with other issues that might prevent the 
software from functioning as expected. 


this book are simple, and their requirements are clearly stated. In the real world, however, 
problems are not always well defined. Developers need to work closely with their customers 
(the individuals or organizations that will use the software) and study the problem carefully to 
identify what the software needs to do. 

System analysis seeks to analyze the data flow and to identify the system’s input and output. 
When you do analysis, it helps to identify what the output is first, and then figure out what 
input data you need in order to produce the output. 

System design is to design a process for obtaining the output from the input. This phase 
involves the use of many levels of abstraction to decompose the problem into manageable 
components, and design strategies for implementing each component. You can view a compo¬ 
nent as a subsystem that performs a specific function of the system. The essence of system 
analysis and design is input, process, and output (IPO). 

Implementation involves translating the system design into programs. Separate programs 
are written for each component and then integrated to work together. This phase requires the 
use of a programming language such as Python. The implementation involves coding, self 
testing, and debugging (that is, finding errors, called bugs, in the code). 

Testing ensures that the code meets the requirements specification and weeds out bugs. An 
independent team of software engineers not involved in the design and implementation of the 
product usually conducts such testing. 

Deployment makes the software available for use. Depending on the type of the soft¬ 
ware, it may be installed on each user’s machine or installed on a server accessible on the 
Internet. 

Maintenance is concerned with updating and improving the product. A software product 
must continue to perform and improve in an ever-evolving environment. This requires periodic 
upgrades of the product to fix newly discovered bugs and incorporate changes. 

To see the software development process in action, we will now create a program that 
computes loan payments. The loan can be a car loan, a student loan, or a home mortgage loan. 
For an introductory programming course, we focus on requirements specification, analysis, 
design, implementation, and testing. 


system analysis 


system design 


IPO 

implementation 


testing 


deployment 


maintenance 



























Elementary Programming 


50 Chapter 2 


Stage 1: Requirements Specification 

The program must satisfy the following requirements: 

■ It must let the user enter the interest rate, the loan amount, and the number of years 
for which payments will be made. 

■ It must compute and display the monthly payment and total payment amounts. 

Stage 2: System Analysis 

The output is the monthly payment and total payment, which can be obtained using the fol¬ 
lowing formula: 

loanAmount X monthlyInterestRate 
monthly Payment -j- 

(1 + monthlyInterestRater’^^"^f^‘^‘‘’'^'^^^ 

totalPayment = monthlyPayment X numberOfYears X 12 

So, the input needed for the program is the annual interest rate, the length of the loan in years, 
and the loan amount. 

Note 

The requirements specification says that the user must enter the interest rate, the loan 
amount, and the number of years for which payments will be made. During analysis, 
however, it is possible that you may discover that input is not sufficient or that some 
values are unnecessary for the output. If this happens, you can go back to modify the 
requirements specification. 



Note 

In the real world, you will work with customers from all walks of life. You may develop 
software for chemists, physicists, engineers, economists, and psychologists and of 
course, you will not have (or need) the complete knowledge of all these fields. There¬ 
fore, you don't have to know how the mathematical formulas are derived. Nonetheless, 
given the annual interest rate, number of years, and loan amount, you can use this for¬ 
mula to compute the monthly payment. You will, however, need to communicate with 
the customers and understand how the mathematic model works for the system. 

Stage 3: System Design 

During system design, you identify the steps in the program: 

Step 1. Prompt the user to enter the annual interest rate, number of years, and loan amount. 

Step 2. The input for the annual interest rate is a number in percent format, such as 4.5%. 

The program needs to convert it into a decimal by dividing it by 100. To obtain the 
monthly interest rate from the annual interest rate, divide it by 12, since a year has 
12 months. So to obtain the monthly interest rate in decimal format, you need to 
divide the annual interest rate in percentage by 1200. For example, if the annual 
interest rate is 4.5%, then the monthly interest rate is 4.5/1200 = 0.00375. 

Step 3. Compute the monthly payment using the formula given in Stage 2. 

Step 4. Compute the total payment, which is the monthly payment multiplied by 12 and 
multiplied by the number of years. 

Step 5. Display the monthly payment and total payment. 
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Stage 4: Implementation 

Implementation is also known as coding (writing the code). In the formula, you have to com¬ 
pute (1 + monthlyInterestRate)'"‘'"^‘''^^‘‘‘''^^^^. You can use the exponentiation operator to 
write it as 

(1 + monthlyInterestRate) ** (numberOfYears * 12) 

Listing 2.8 gives the complete program. 

enter interest rate 
obtain monthly interest rate 

enter years 

enter loan amount 

month!yPayment 
total Payment 

display result 


Listing 2.8 ComputeLoan. py 

1 # Enter annual interest rate as a percentage, e.g., 7.25 

2 annualInterestRate = eval(input( 

3 "Enter annual interest rate, e.g., 7.25; ")) 

4 monthlyInterestRate = annualInterestRate / 1200 

5 

6 # Enter number of years 

7 numberOfYears = eval(input( 

8 "Enter number of years as an integer, e.g., 5: ")) 

9 

10 # Enter loan amount 

11 loanAmount = eval (i nput("Enter loan amount, e.g., 120000.95: ")) 

12 

13 # Calculate payment 

14 monthlyPayment = loanAmount * monthlyInterestRate / (1 

15 - 1 / (1 + monthlyInterestRate) ** (numberOfYears * 12)) 

16 total Payment = monthlyPayment * numberOfYears * 12 

17 

18 # Display results 

19 printC'The monthly payment is", i nt(monthlyPayment * 100) / 100) 

20 printC'The total payment is", int(totalPayment * 100) /lOO) 


Enter annual interest rate, e.g., 7.25: 5.75 pMeTI 
Enter number of years as an integer, e.g., 5: 15 Enter 
Enter loan amount, e.g., 120000.95: 250000 Enter| 

The monthly payment is 2076.02 
The total payment is 373684.53 




Os. 
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format numbers 


incremental development and 
testing 


IP J Point 


enter xl, yl 


enter x2, y2 


compute di stance 



Line 2 reads the annual interest rate, which is converted into the monthly interest rate in 
line 4. 

The formula for computing the monthly payment is translated into Python code in lines 
14-15. 

The variable month!yPayment is 2076.0252175 (line 14). Note that 

i nt(monthlyPayment * 100) is 207602.52175 
int(monthlyPayment * 100) / 100.0 is 2076.02 

So, the statement in line 19 displays the tax 2076.02 with two digits after the decimal 
point. 


Stage 5: Testing 

After the program is implemented, test it with some sample input data and verify whether the 
output is correct. Some of the problems may involve many cases as you will see in later chap¬ 
ters. For this type of problems, you need to design test data that cover all cases. 

Tip 

The system design phase in this example identified several steps. It is a good approach 
to develop and test these steps incrementally by adding them one at a time. This 
process makes it much easier to pinpoint problems and debug the program. 



2.14 Case Study: Computing Distances 

This section presents two programs that compute and display the distance between two 
points. 

Given two points, the formula for computing the distance is '\/(x 2 — xi)^ + (y 2 ~ y{f. 
You can use a ** 0 .5 to compute a/g. The program in Listing 2.9 prompts the user to enter 
two points and computes the distance between them. 

Listing 2.9 ComputeDistance.py 

1 # Enter the first point with two float values 

2 xl, yl = eval(i nputC'Enter xl and yl for Point 1 : ")) 

3 

4 # Enter the second point with two float values 

5 x2, y2 = eval(i nputC'Enter x2 and y2 for Point 2: ")) 

6 

7 # Compute the distance 

8 distance = ((xl - x2) * (xl - x2) + (yl - y2) * (yl - y2)) ** 0.5 

9 

10 printC'The distance between the two points is", distance) 


Enter xl and yl for Point 1; 1.5, — 3.4 
Enter x2 and y2 for Point 2: 4, 5 

The distance between the two points is 8.764131445842194 


The program prompts the user to enter the coordinates of the first point (line 2) and the 
second point (line 5). It then computes the distance between them (line 8) and displays it 
(line 10). 
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Figure 2.3 The program displays a line and its length. 


Figure 2.3 illustrates the program in Listing 2.10. This program 

1. Prompts the user to enter two points. 

2. Computes the distance between the points. 

3. Uses Turtle graphics to display the line that connects the two points. 

4. Displays the length of the line at the center of the line. 

Listing 2.10 gives the program. 


Listing 2.10 ComputeDi stanceCraphi cs. py 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 
23 


import turtle 

# Prompt the user for inputting two points 

xl, yl = eval(i nputC'Enter xl and yl for point 1: ")) 

x2, y2 = eval(i nputC'Enter x2 and y2 for point 2: ")) 


# Compute the distance 

distance = ((xl - x2) ** 2 + (yl - y2) ** 2) ** 0.5 


# Display two points and the connecting line 
turtl e. penupO 

turtle.goto(xl, yl) # Move to (xl, yl) 
turtl e. pendownO 
turtle. writeC'Point 1”) 

turtle.goto(x2, y2) # Draw a line to (x2, y2) 
turtle. writeC'Point 2") 


# Move to the center point of the line 
turtl e. penupO 

turtle.goto((xl + x2) / 2, (yl + y2) / 2) 
turtle.write(distance) 


turtl e. doneO 


import turtle 

enter xl, yl 
enter x2, y2 


compute distance 


move to point 1 

display point 1 
draw a line 
display point 2 


move to center 
display distance 

pause 


Enter 

xl 

and 

yl 

for 

Point 1: 

50, 

34 Enter j 

Enter 

x2 

and 

y2 

for 

Point 2: 

49, 

“85 Enter] 



The program prompts the user to enter the value for two points (xl, yl) and (x2, y2), 
and computes their distance (lines 4-8). It then moves to (xl, yl) (line 12), displays the 
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text Point 1 (line 14), draws a line from (xl, yl) to Cx2, y2) (line 15), and displays the 
text Point 2 (line 16). Finally, it moves to the center of the line (line 20) and displays the 
distance (line 21). 


Key Terms 


algorithm 32 
assignment operator (=) 37 

augmented assignment 44 
camelCase 36 
compound assignment 44 
data type 33 
expression 37 
floating-point numbers 40 
identifiers 36 

incremental development and testing 52 
input, process, output (IPO) 35 
keyword 36 


line continuation symbol 35 
literal 40 
operands 40 
operators 40 
pseudocode 32 
reserved word 36 
scope of a variable 37 
simultaneous assignment 38 
system analysis 49 
system design 49 
type conversion 45 
variable 32 


Chapter Summary 


1. You can get input using the input function and convert a string into a numerical 
value using the eval function. 

2. Identifiers are the names used for elements in a program. 

3. An identifier is a sequence of characters of any length that consists of letters, digits, 
underscores ( ), and asterisk signs (*). An identifier must start with a letter or an 
underscore; it cannot start with a digit. An identifier cannot be a keyword. 

4. Variables are used to store data in a program. 

5. The equal sign (=) is used as the assignment operator. 

6 . A variable must be assigned a value before it can be used. 

7. There are two types of numeric data in Python: integers and real numbers. Integer 
types (inf for short) are for whole numbers, and real types (also called/loaf) are for 
numbers with a decimal point. 

8 . Python provides assignment operators that perform numeric operations: + (addi¬ 
tion), (subtraction), * (multiplication), / (division), // (integer division), % 
(remainder), and (exponent). 

9. The numeric operators in a Python expression are applied the same way as in an arith¬ 
metic expression. 

10. Python provides augmented assignment operators: -i-= (addition assignment), -= 
(subtraction assignment), *= (multiplication assignment), /= (float division assign¬ 
ment), //= (integer division assignment), and %= (remainder assignment). These 
operators combine the -r, -, *, /, //, and % operators and the assignment operator 
into one augmented operators. 
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I I . When evaluating an expression with values of an int type and a float type, Python 
automatically converts the int value to a float type value. 

12. You can convert a float to an int using the i nt (val ue) function. 

13. System analysis seeks to analyze the data flow and to identify the system’s input and 
output. 

14- System design is the stage when programmers develop a process for obtaining the 
output from the input. 

15. The essence of system analysis and design is input, process, and output. This is called 
IPO. 

Test Questions 

Do test questions for this chapter online at www.cs.armstrong.edu/liang/py/test.html. 

Programming Exercises 



Pedagogical Note 

Instructors may ask you to document analysis and design for selected exercises. 
You should use your own words to analyze the problem, including the input, output, 
and what needs to be computed, and describe how to solve the problem in 
pseudocode. 


Debugging Tip 

python usually gives a reason for a syntax error. If you don't know how to correct it, 
compare your program closely, character by character, with similar examples in the text. 

Sections 2.2-2.10 

2.1 {Convert Celsius to Fahrenheit) Write a program that reads a Celsius degree from 
the console and converts it to Fahrenheit and displays the result. The formula for 
the conversion is as follows: 

Fahrenheit = (9 / 5) * Celsius + 32 

Here is a sample run of the program: 



Enter a degree in Celsius: 43 
43 Celsius is 109.4 Fahrenheit 


2.2 (Compute the volume of a cylinder) Write a program that reads in the radius and 
length of a cylinder and computes the area and volume using the following formulas: 

area = radius * radius * n 
volume = area * length 

Here is a sample run: 


MyProgrammingLab" 


document analysis and design 


learn from examples 
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Enter the radius and length of a cylinder: 5.5, 12 ^^Emerj 

The area is 95.0331 

The volume is 1140.4 

2.3 

(Convert feet into meters) Write a program that reads a number in feet, converts it 
to meters, and displays the result. One foot is 0.305 meters. Here is a sample run: 


Enter a value for feet: 16.5 enter| 

16.5 feet is 5.0325 meters 

2.4 

(Convert pounds into kilograms) Write a program that converts pounds into 
kilograms. The program prompts the user to enter a value in pounds, converts it to 
kilograms, and displays the result. One pound is 0.454 kilograms. Here is a 
sample run: 

Enter a value in pounds: 55.5 enter 

55.5 pounds is 25.197 kilograms 

* 2.5 

(Financial application: calculate tips) Write a program that reads the subtotal and 
the gratuity rate and computes the gratuity and total. For example, if the user 
enters 10 for the subtotal and 15% for the gratuity rate, the program displays 1.5 
as the gratuity and 11.5 as the total. Here is a sample run: 


Enter the subtotal and a gratuity rate: 15.69, 15 enter 

The gratuity is 2.35 and the total is 18.04 

** 2.6 

(Sum the digits in an integer) Write a program that reads an integer between 0 and 
1000 and adds all the digits in the integer. For example, if an integer is 932, the 
sum of all its digits is 14. (Hint: Use the % operator to extract digits, and use the // 
operator to remove the extracted digit. For instance, 932 % 10 = 2 and 932 // 
10 = 93.) Here is a sample run: 


Enter a number between 0 and 1000: 999 enter| 

The sum of the digits is 27 

** 2.7 

(Find the number of years and days) Write a program that prompts the user to 
enter the minutes (e.g., 1 billion), and displays the number of years and days for 
the minutes. For simplicity, assume a year has 365 days. Here is a sample run: 


Enter the number of minutes: 1000000000 |^enter| 

1000000000 minutes is approximately 1902 years and 214 days 


2.8 (Science: calculate energy) Write a program that calculates the energy needed to 
heat water from an initial temperature to a final temperature. Your program should 
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prompt the user to enter the amount of water in kilograms and the initial and final 
temperatures of the water. The formula to compute the energy is 

Q = M * (ftnalTemperature - initialTemperature) * 4184 

where M is the weight of water in kilograms, temperatures are in degrees Celsius, 
and energy Q is measured in joules. Here is a sample run: 


Enter the amount of water in kilograms: 55.5 
Enter the initial temperature: 3.5 [ —I Enter | 
Enter the final temperature: 10.5 |^EntT| 

The energy needed is 1625484.0 



* 2.9 {Science: wind-chill temperature) How cold is it outside? The temperature alone is 
not enough to provide the answer. Other factors including wind speed, relative 
humidity, and sunshine play important roles in determining coldness outside. In 
2001, the National Weather Service (NWS) implemented the new wind-chill tem¬ 
perature to measure the coldness using temperature and wind speed. The formula 
is given as follows: 

t^^ = 35.74 4- 0.6215t„ - 35.75v° '® -f 0.4275cv° '® 

where t^ is the outside temperature measured in degrees Fahrenheit and v is the 
speed measured in miles per hour. t„c is the wind-chill temperature. The formula 
cannot be used for wind speeds below 2 mph or for temperatures below —58°F or 
above 41°F. 

Write a program that prompts the user to enter a temperature between —58°F and 
41°F and a wind speed greater than or equal to 2 and displays the wind-chill tem¬ 
perature. Here is a sample run: 


Enter the temperature in Fahrenheit between -58 and 41: 5.3 [center| 
Enter the wind speed in miles per hour: 6 [ -j Entei^I 
The wind chill index is -5.56707 



* 2.10 {Physics: find runway length) Given an airplane’s acceleration a and take-off 
speed V, you can compute the minimum runway length needed for an airplane to 
take off using the following formula: 


length = — 

2a 

Write a program that prompts the user to enter v in meters/second (m/s) and the 
acceleration a in meters/second squared (m/s^), and displays the minimum runway 
length. Here is a sample run: 


Enter speed and acceleration: 60, 3.5 [ —I Enter | 

The minimum runway length for this airplane is 514.286 meters 
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*2.1 I (Financial application: investment amount) Suppose you want to deposit a 
certain amount of money into a savings account with a fixed annual interest rate. 
What amount do you need to deposit in order to have $5,000 in the account after 
three years? The initial deposit amount can be obtained using the following 
formula: 


finalAccountValue 

initialDepositAmount = ---— , , 

(1 + monthlyInterestRatey'“"'‘’‘^''^^°''‘^^ 

Write a program that prompts the user to enter final account value, annual interest 
rate in percent, and the number of years, and displays the initial deposit amount. 
Here is a sample run: 




Enter final account value: 1000 |tEnter| 

Enter annual interest rate in percent: 4.25 |yenter 

Enter number of years: 5 |^enter 

Initial deposit value is 808.8639197424636 


2.12 (Print a table) Write a program that displays the following table: 

aba ** b 
12 1 

2 3 8 

3 4 81 

4 5 1024 

5 6 15625 

*2.1 3 (Split digits) Write a program that prompts the user to enter a four-digit integer 
and displays the number in reverse order. Here is a sample run: 



Enter an integer: 3125 ll.t-i Enter 
3 
1 
2 
5 


*2.14 (Geometry: area of a triangle) Write a program that prompts the user to enter the 
three points (xl, yl), Cx2, y2), and (x3, y3) of a triangle and displays its area. 
The formula for computing the area of a triangle is 

s = (side\ + side2 + side3) / 2 

area = s/s(s — sidel)(s — side2)(s — side3) 

Here is a sample run: 



Enter three points for a triangle: 1.5, -3.4, 4.6, 5, 
9.5, “3.4 Enter j 

The area of the triangle is 33.6 
















Programming Exercises 59 


2.15 


(Geometry: area of a hexagon) Write a program that prompts the user to enter the 
side of a hexagon and displays its area. The formula for computing the area of a 


hexagon is Area 



where s is the length of a side. Here is a sample run; 


Enter the side: 5.5 

The area of the hexagon is 78.5895 



2.16 (Physics: acceleration) Average acceleration is defined as the change of velocity 
divided by the time taken to make the change, as shown in the following formula: 


Vi - Vo 

a = - 

t 

Write a program that prompts the user to enter the starting velocity vq in 
meters/second, the ending velocity Vj in meters/second, and the time span t in 
seconds, and displays the average acceleration. Here is a sample run: 


Enter vO, vl, and t: 5.5, 50.9, 4.5 enter| 
The average acceleration is 10.0889 



*2.17 (Health application: compute BMP) Body mass index (BMI) is a measure of health 
based on weight. It can be calculated by taking your weight in kilograms and 
dividing it by the square of your height in meters. Write a program that prompts 
the user to enter a weight in pounds and height in inches and displays the BMI. 
Note that one pound is 0.45359237 kilograms and one inch is 0.0254 meters. 
Here is a sample run: 


Enter weight in 

pounds: 

95.5 Enter 

Enter height in 

inches: 

50 

BMI is 26.8573 





Sections 2.11-2.13 

*2.18 (Current time) Listing 2.7, ShowCurrentTime.py, gives a program that displays the 
current time in GMT. Revise the program so that it prompts the user to enter the 
time zone in hours away from (offset to) GMT and displays the time in the speci¬ 
fied time zone. Here is a sample run: 


Enter the time zone offset to GMT: -5 
The current time is 4:50:34 
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*2.19 {Financial application: calculate future investment value) Write a program that 
reads in an investment amount, the annual interest rate, and the number of years, 
and displays the future investment value using the following formula; 

futureInvestmentValue = investment Amount X (1 + inonthlylnterestRate)’""'''”’''^™'''^ 

For example, if you enter the amount 1000, an annual interest rate of 4.2 5%, 
and the number of years as 1, the future investment value is 1043.33. Here is a 
sample run: 


Enter investment amount: 1000 | «-i Enter~j 

Enter annual interest rate: 4.25 | --I Enter I 

Enter number of years: 1 enter| 
Accumulated value is 1043.33 


*2.20 {Financial application: calculate interest) If you know the balance and the annual 
percentage interest rate, you can compute the interest on the next monthly pay¬ 
ment using the following formula: 

interest = balance * (annualInterestRate / 1200) 

Write a program that reads the balance and the annual percentage interest rate 
and displays the interest for the next month. Here is a sample run: 



Enter balance and interest rate (e.g., 3 for 3%): 1000, 3.5 |.JEnter'| 
The interest is 2.91667 


**2.21 {Financial application: compound value) Suppose you save $100 each month into 
a savings account with an annual interest rate of 5%. Therefore, the monthly inter¬ 
est rate is 0.05/12 = 0.00417. After the first month, the value in the account 
becomes 

100 * (1 -h 0.00417) = 100.417 
After the second month, the value in the account becomes 
(100 + 100.417) * (1 + 0.00417) = 201.252 
After the third month, the value in the account becomes 
(100 + 201.252) * (1 + 0.00417) = 302.507 
and so on. 

Write a program that prompts the user to enter a monthly saving amount and 
displays the account value after the sixth month. Here is a sample run of the 
program: 
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Enter the monthly saving amount: 100 ^^Enterj 
After the sixth month, the account value is 608.81 



2.22 {Population projection) Rewrite Exercise 1.11 to prompt the user to enter the 
number of years and displays the population after that many years. Here is a 
sample run of the program: 


Enter the number of years: 5 

The population in 5 years is 325932970 



Section 2.14 

2.23 {Turtle: draw four circles) Write a program that prompts the user to enter the 
radius and draws four circles in the center of the screen, as shown in Figure 2.4a. 

2.24 {Turtle: draw four hexagons) Write a program that draws four hexagons in the 
center of the screen, as shown in Figure 2.4b. 

**2.25 {Turtle: draw a rectangle) Write a program that prompts the user to enter the 
center of a rectangle, width, and height, and displays the rectangle, as shown in 
Figure 2.4c. 



Figure 2.4 Four circles are drawn in (a), four hexagons are drawn in (b), and a rectangle is drawn in (c). 


**2.26 {Turtle: draw a circle) Write a program that prompts the user to enter the 
center and radius of a circle, and then displays the circle and its area, as shown 
in Figure 2.5. 



Figure 2.5 A circle and its area are displayed. 
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CHAPTER 


3 

Mathematical 

Functions, 

Strings, 

AND Objects 

objectives 

■ To solve mathematics problems by using the functions in the math 
module (§3.2). 

■ To represent and process strings and characters (§§3.3-3.4). 

■ To encode characters using ASCII and Unicode (§§3.3.1-3.3.2). 

■ To use the ord function to obtain a numerical code for a character and the 
chr function to convert a numerical code to a character (§3.3.3). 

■ To represent special characters using the escape sequence (§3.3.4). 

■ To invoke the print function with the end argument (§3.3.5). 

■ To convert numbers to a string using the str function (§3.3.6). 

■ To use the + operator to concatenate strings (§3.3.7). 

■ To read strings from the keyboard (§3.3.8). 

■ To introduce objects and methods (§3.5). 

■ To format numbers and strings using the format function (§3.6). 

■ To draw various shapes (§3.7). 

■ To draw graphics with colors and fonts (§3.8). 
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problem 


3.1 Introduction 

-^(^Key The focus of this chapter is to introduce functions, strings, and objects, and to use 
''I Point them to develop programs. 

The preceding chapter introduced fundamental programming techniques and taught you how 
to write simple programs to solve basic problems. This chapter introduces Python functions 
for performing common mathematical operations. You will learn how to create custom func¬ 
tions in Chapter 6. 

Suppose you need to estimate the area enclosed by four cities, given the GPS locations (lat¬ 
itude and longitude) of these cities, as shown in the following diagram. How would you write 
a program to solve this problem? You will be able to write such a program after completing 
this chapter. 


Atlanta 

(33.7489954, -84.3879824) 


Charlotte (35.2270869, -80.8431267) 



Savannah (32.0835407, -81.0998342) 


Orlando (28.5383355,-81.3792365) 


Because all data in Python are objects, it is beneficial to introduce objects early so that you 
can begin to use them to develop useful programs. This chapter gives a brief introduction to 
objects and strings; you will learn more on objects and strings in Chapters 7 and 8. 


function 


Y/ Point 


3.2 Common Python Functions 

Python provides many useful functions for common programming tasks. 

A function is a group of statements that performs a specific task. Python, as well as other 
programming languages, provides a library of functions. You have already used the func¬ 
tions eval, input, print, and int. These are built-in functions and they are always avail¬ 
able in the Python interpreter. You don’t have to import any modules to use these functions. 
Additionally, you can use the built-in functions abs, max, mi n, pow, and round, as shown in 
Table 3.1. 


Table 3.1 Simple Python Built-in Functions 

Function Description 


abs(x) 

max(xl, x2, ...) 
min(xl, x2, ...) 
pow(a, b) 


Returns the absolute value for x. 
Returns the largest among xl, x2, ... 
Returns the smallest among xl, x2, ... 
Returns a*”. Same as a * * b. 


round (x) Returns an integer nearest to x. If x 

is equally close to two integers, 
the even one is returned. 


Returns the float value rounded to n 
digits after the decimal point. 


Example 

abs(-2) is 2 
max(l, 5, 2) is 5 
ttiinCl, 5, 2) is 1 
pow(2, 3) is 8 
roundCS.4) is 5 
round(5.5) is 6 
round(4.5) is 4 
round(5.466, 2) is 5.47 
roundCS.463, 2) is 5.46 


round(x, n) 
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For example, 


»> abs(-3) # Returns the absolute value 

3 

»> abs(-3.5) # Returns the absolute value 
3.5 

»> max(2, 3, 4, 6) # Returns the maximum number 
6 

»> mln(2, 3, 4) # Returns the minimum number 
2 

»> pow(2, 3) # Same as 2 ** 3 
8 

»> pow(2.5, 3.5) # Same as 2.5 ** 3.5 
24.705294220065465 

»> round(3.51) # Rounds to its nearest integer 

4 

»> round(3.4) # Rounds to its nearest integer 
3 

»> round(3.1456, 3) # Rounds to 3 digits after the decimal point 
3.146 
»> 



Many programs are created to solve mathematical problems. The Python math module 
provides the mathematical functions listed in Table 3.2. 

Two mathematical constants, p i and e, are also defined in the math module. They can be 
accessed using math.pi and math.e. Listing 3.1 is a program that tests some math func¬ 
tions. Because the program uses the math functions defined in the math module, the math 
module is imported in line 1. 


Table 3.2 Mathematical Functions 


Function 

Description 

Example 

fabs(x) 

Returns the absolute value for x as a float. 

fabs(-2) is 2.0 

ceil(x) 

Rounds X up to its nearest integer and returns that integer. 

ceil (2.1) is 3 
ceil (-2.1) is -2 

floor (x) 

Rounds X down to its nearest integer and returns that integer. 

floor(2.1) is 2 
floor(-2.1) is -3 

expCx) 

Returns the exponential function of x (e*). 

exp(l) is 2.71828 

logCx) 

Returns the natural logarithm of x. 

log(2.71828) is 1.0 

logCx, base) 

Returns the logarithm of x for the specified base. 

logClOO, 10) is 2.0 

sqrt(x) 

Returns the square root of x. 

sqrt(4.0) is 2 

sinCx) 

Returns the sine of x. x represents an angle in radians. 

sin(3.14159 / 2) is 1 
sin(3.14159) is 0 

asin(x) 

Returns the angle in radians for the inverse of sine. 

asin(l.O) is 1.57 
asin(0.5) isO. 523599 

cos(x) 

Returns the cosine of x. x represents an angle in radians. 

cos(3.14159 / 2) isO 
cos(3.14159) is -1 

acos(x) 

Returns the angle in radians for the inverse of cosine. 

acos (1.0) is 0 
acos(0.5) is 1.0472 

tanCx) 

Returns the tangent of x. x represents an angle in radians. 

tan(3.14159 / 4) is 1 
tan(0.0) is 0 

degrees(x) 

Converts angle x from radians to degrees. 

degrees(l. 57) is 90 

radians(x) 

Converts angle x from degrees to radians. 

radians(90) is 1.57 
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Listing 3.1 MathFunctions.py 


import math module 

1 

T 

import math # import 

math module to use 

the math functions 


L 

3 

# Test algebraic functions 


exp 

4 

print("exp(1.0) =" , math.exp(l)) 


log 

5 

print("log(2.78) =", 

math.Iog(math.e)) 


logic 

6 

print("logl0(10, 10) 

=", math.log(10, 10)) 

sqrt 

7 

print("sqrt(4.0) =", 

math.sqrt(4.0)) 



8 

9 

# Test trigonometric 

functions 


si n 

10 

print("sin(PI / 2) =' 

math.sin(math.pi 

/ 2)) 

cos 

11 

print("cos(PI / 2) =' 

math.cos(math.pi 

/ 2)) 

tan 

12 

print("tan(PI / 2) =' 

math.tan(math.pi 

/ 2)) 

degrees 

13 

print ("degrees(1.57) 

=", math.degrees(l. 

57)) 

radians 

14 

print("radians(90) =' 

math.radians (90)) 



exp(l.O) = 2.71828182846 

log(2.78) = 1.0 

loglOClO, 10) = 1.0 

sqrt(4.0) = 2.0 

sin(PI / 2) = 1.0 

cos(PI / 2) = 6.123233995746-17 

tan(PI / 2) = 1.633123935326+16 

d6gr66s(1.57) = 89.9543738355 

radians(90) = 1.57079632679 


You can use the math functions to solve many computational problems. Given the three 
vertices of a triangle, for example, you can compute the angles by using the following formula: 


x2, y2 



A = acosCCa * a 
B = acos((b * b 
C = acos((c * c 


b 

a 

b 


b 

a 

b 


c 

c 


a 


c) / (-2 
c) / (-2 
a) / (-2 


b * c)) 
a * c)) 
a * b)) 


import math module 
enter three points 
compute edges 


Don’t be intimidated by the mathematic formula. As we discussed early in Listing 2.8, 
ComuteLoan.py, you don’t have to know how the mathematical formula is derived in order to 
write a program for computing the loan payments. Here in this example, given the length of 
three sides, you can use this formula to write a program to compute the angles without having 
to know how the formula is derived. In order to compute the lengths of the sides, we need to 
know the coordinates of three comer points and compute the distances between the points. 

Listing 3.2 is an example of a program that prompts the user to enter the x- and y-coordinates 
of the three comer points in a triangle and then displays the figure’s angles. 

Listing 3.2 ComputeAngl es. py 

1 import math 

2 

3 xl, yl, x2, y2, x3, y3 = eval(i nput("Enter three points: ")) 

4 

5 a = math.sqrt((x2 - x3) * (x2 - x3) + (y2 - y3) * (y2 - y3)) 

6 b = math.sqrt((xl - x3) * (xl - x3) + (yl - y3) * (yl - y3)) 

7 c = math.sqrt((xl - x2) * (xl - x2) + (yl - y2) * (yl - y2)) 
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8 

9 A = math.degrees(math.acos((a * a - b * b - c * c) / (-2 * b * c))) 

10 B = math.degrees(math.acos((b * b - a * a - c * c) / (-2 * a * c))) 

11 C = math.degrees(math.acos((c * c - b * b - a * a) / (-2 * a * b))) 

12 

13 printC'The three angles are ", round(A * 100) / 100.0, 

14 round (B * 100) / 100.0, round(C * 100) / 100.0) 


compute angles 


display result 


Enter three points: 1, 1, 6.5, 1, 6.5, 2.5 I Enter 
The three angles are 15.26 90.0 74.74 



The program prompts the user to enter three points (line 3). This prompting message is not 
clear. You should give the user explicit instructions on how to enter these points as follows: 

inputC'Enter six coordinates of three points separated by commas\ 
like xl, yl, x2, y2, x3, y3: ") 

The program computes the distances between the points (lines 5-7), and applies the for¬ 
mula to compute the angles (lines 9-11). The angles are rounded to display up to two digits 
after the decimal point (lines 13-14). 


3.1 Evaluate the following functions: 

(a) math. sqrt(4) 

(b) math.si n(2 * math.pi) 

(c) math.cos (2 * math.pi) 

(d) min(2, 2, 1) 

(e) math.1og(math.e) 

(f) math. exp(l) 

(g) max(2, 3, 4) 

(h) abs(-2.5) 

(i) math. cei 1 (-2 . 5) 


(j) math.floor(-2.5) 

(k) round (3.5) 

(l) round(-2.5) 

(m) math.Tabs (2 . 5) 

(n) math.cei1 (2 . 5) 

(o) math.floor (2 . 5) 

(p) round(-2.5) 

(q) round (2.6) 

(r) round(math. fabs(-2 . 5)) 


W P( 


heck 

Point 


MyProgrammingLab" 


3.2 True or false? The argument for trigonometric functions represents an angle in radians. 

3.3 Write a statement that converts 47 degrees to radians and assigns the result to a variable. 

3.4 Write a statement that converts 71/ 7 to an angle in degrees and assigns the result to 
a variable. 


3.3 Strings and Characters 

A string (described in Chapter 1) is a sequence of characters. Python treats characters 
and strings the same way. 


Key 
^ (Point 


In addition to processing numeric values, you can process strings in Python. A string is a 
sequence of characters and can include text and numbers. String values must be enclosed in 
matching single quotes ( ' ) or double quotes ("). Python does not have a data type for charac¬ 
ters. A single-character string represents a character. For example, 


string 


single quotes or double 
quotes 


letter = 'A' # Same as letter = "A" 
numChar = '4' # Same as numChar = "4" 

message = 'Good morning" # Same as message = 'Good morning' 
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chai'acter encoding 


The first statement assigns a string with the character A to the variable letter. The sec¬ 
ond statement assigns a string with the digit character 4 to the variable numChar. The third 
statement assigns the string Good morning to the variable message. 


Note 

For consistency, this book uses double quotes for a string with more than one character 
and single quotes for a string with a single character or an empty string. This convention 
is consistent with other programming languages, so it will be easy for you to convert a 
Python program to a program written in other languages. 



3.3.1 ASCII Code 

Computers use binary numbers internally (see Section 1.2.2). A character is stored in a 
computer as a sequence of Os and Is. Mapping a character to its binary representation is called 
character encoding. There are different ways to encode a character. The manner in which 
characters are encoded is defined by an encoding scheme. One popular standard is ASCII 
(American Standard Code for Information Interchange), a 7-bit encoding scheme for repre¬ 
senting all uppercase and lowercase letters, digits, punctuation marks, and control characters. 
ASCII uses numbers 0 through 127 to represent characters. Appendix B, The ASCII Charac¬ 
ter Set, shows the ASCII code for characters. 


3.3.2 Unicode Code 

Python also supports Unicode. Unicode is an encoding scheme for representing interna¬ 
tional characters. ASCII is a small subset of Unicode. Unicode was established by the 
Unicode Consortium to support the interchange, processing, and display of written texts 
in the world’s diverse languages. A Unicode starts with \u, followed by four hexadecimal 
digits that run from \u0000 to \uFFFF. (For information on hexadecimal numbers, see 
Appendix C.) For example, the word “welcome” is translated into Chinese using 
two characters, )0\( and jQl. The Unicode representations of these two characters are 
\u6B22\u8FCE. 

The program in Listing 3.3 displays two Chinese characters and three Greek letters, as 
shown in Figure 3.1. 

Listing 3.3 DisplayUnicode.py 

1 import turtle 

2 

3 turtle. write("\u6B22\u8FCE \u03bl \u03b2 \u03b3'') 

4 

5 turtle.doneO 


Python 

Turtle Graphics JnslUsyiifSHl 


d 


5ISaPv _j 



<1 

- 1 ^ 


Figure 3.1 You can use Unicode to display international characters in a Python GUI 
program. 


If no Chinese font is installed on your system, you will not be able to see the Chinese char¬ 
acters. In this case, delete \u6B22\u8FCE from your program to avoid errors. The Unicode 
codes for the Greek letters a, (3, and y are \u03bl, \u03b2, and \u03b3. 
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3.3.3 The ord and chr Functions 

Python provides the orcl(ch) function for returning the ASCII code for the character ch 
and the chr(code) function for returning the character represented by the code. For 
example, 


»> ch = 'a' 
»> ord(ch) 
97 

»> chr(98) 
'b' 

»> ord('A') 
65 
»> 



The ASCII code for a is 97, which is greater than the code for A (65). The ASCII code for 
lowercase letters are consecutive integers starting from the code for a, then for b, c, and so on, 
up to the letter z. The same is true for the uppercase letters. The difference between the ASCII 
code of any lowercase letter and its corresponding uppercase letter is the same: 32. This is a 
useful property for processing characters. For example, you can find the uppercase represen¬ 
tation of any lowercase letter, as shown in the following code: 


1 

»> 

ord('a') - ord('A') 

2 

32 


3 

»> 

ord('d') - ord('D') 

4 

32 


5 

»> 

offset = ord('a') - ord('A') 

6 

»> 

lowercaseLetter = 'h' 

7 

»> 

uppercaseLetter = chr(ord(IowercaseLetter) - offset) 

8 

»> 

uppercaseLetter 

9 

'H' 


10 

»> 




Line 6 assigns a lowercase letter to variable lowercaseLetter. Line 7 obtains its corre¬ 
sponding uppercase letter. 

3.3.4 Escape Sequences for Special Characters 

Suppose you want to print a message with quotation marks in the output. Can you write a 
statement like this? 

printC'He said, "John's program is easy to read'"’) 


backslash (\) 
escape sequence 
newline 
line break 

end-of-line (EOL) character 


No, this statement has an error. Python thinks the second quotation mark is the end of the 
string and does not know what to do with the rest of the characters. 

To overcome this problem. Python uses a special notation to represent special characters, 
as shown in Table 3.3. This special notation, which consists of a backslash (\) followed by a 
letter or a combination of digits, is called an escape sequence. 

The \n character is also known as a newline, line break or end-of-line (EOL) character, 
which signifies the end of a line. The \f character forces the printer to print from the next 
page. The \r character is used to move the cursor to the first position on the same line. The \f 
and \r characters are rarely used in this book. 
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Table 3.3 Python Escape Sequences 


Character Escape Sequence Name Numeric Value 


\b 

Backspace 

8 

\t 

Tab 

9 

\n 

Linefeed 

10 

\f 

Formfeed 

12 

\r 

Carriage Return 

13 

W 

Backslash 

92 

\' 

Single Quote 

39 

\" 

Double Quote 

34 


Now you can print the quoted message using the following statement: 




Note that the symbols \ and together represent one character. 


»> printC'He said, \"3ohn's program is easy to read\"' ) 
He said, "John's program is easy to read" 


3.3.5 Printing without the Newline 

When you use the print function, it automatically prints a linefeed (\n) to cause the out¬ 
put to advance to the next line. If you don’t want this to happen after the print function is 
finished, you can invoke the print function by passing a special argument end 
"anyendingstring" using the following syntax: 

printCitem, end = "anyendingstring") 

For example, the following code 

1 printC'AAA", end = ' ') 

2 printC'BBB", end = ") 

3 printC'CCC , end = '***') 

4 printF'DDD' , end = '***') 

displays 

AAA BBBCCC***DDD*** 

Line 1 prints AAA followed by a space character ' ' , line 2 prints BBB, line 3 prints CCC 

followed by *••*, and line 4 prints DDD followed by ***. Note that ' ' in line 2 means an 
empty string. So, nothing is printed for ' ' . 

You can also use the end argument for printing multiple items using the following syntax: 
printCiteml, item2, ..., end = "anyendingstring") 

For example, 
radius = 3 

print ("The area is", radius * radius * math.pi, end = ') 

printC'and the perimeter is", 2 * radius) 

displays 

The area is 28.26 and the perimeter is 6 
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3.3.6 The str Function 

The str function can be used to convert a number into a string. For example, 


»> s = str(3.4) # Convert a float to string 

»> s 

'3.4' 

»> s = str(3) # Convert an integer to string 

»> s 

'3' 

»> 



3.3.7 The String Concatenation Operator 

You can use the + operator to add two numbers. The + operator can be used to concatenate 
two strings. Here are some examples: 


1 »> message = "Welcome " + "to " + "Python" 

2 »> message 

3 'Welcome to Python' 

4 »> chapterNo = 3 

5 »> s = "Chapter " + str(chapterNo) 

6 »> s 

7 'Chapter 3' 

8 »> 



Line 1 concatenates three strings into one. In line 5, the str function converts the numeric 
value in variable chapterNo to a string. This string is concatenated with "Chapter to 
obtain the new string "Chapter 3". 

The augmented assignment += operator can also be used for string concatenation. For 
example, the following code concatenates the string in message with the string and 

Python is fun". 


»> message = "Welcome to Python" 

»> message 
'Welcome to Python' 

»> message += " and Python is fun" 
»> message 

'Welcome to Python and Python is fun' 
»> 



3.3.8 Reading Strings from the Console 

To read a string from the console, use the input function. For example, the following code 
reads three strings from the keyboard: 

si = inputC'Enter a string: ") 
s2 = inputC'Enter a string: ") 
s3 = inputC'Enter a string: ") 
printC'sl is " + si) 
print("s2 is " + s2) 
print("s3 is " + s3) 
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MyProgrammingLab" 


minimum number of coins 



3.5 Use the ord function to find the ASCII code for 1, A, B, a, and b. Use the chr 
function to find the character for the decimal codes 40, 59, 79, 85, and 90. 

3.6 How do you display the characters \ and ? 

3.7 How do you write a character in Unicode? 

3.8 Suppose you entered A when running the following code. What is the output? 

X = inputC'Enter a character: ”) 

ch = chr(ord(x) + 3) 
print(ch) 

3.9 Suppose you entered A and Z when running the following code. What is the 
output? 

X = inputC'Enter a character: ") 
y = inputC'Enter a character: ") 
print(ord(y) - ord(x)) 

3.10 What is wrong in the following code? How do you fix it? 
title = "Chapter " + 1 

3.11 Show the result of the following code: 
sum =2+3 

print(sum) 
s = '2' + '3' 
print(s) 


3.4 Case Study: Minimum Number of Coins 

Now let’s look at a sample program that uses the features covered in this section. Suppose you 
want to develop a program that classifies a given amount of money into smaller monetary 
units. The program lets the user enter an amount as a floating-point value representing a total 
in dollars and cents, and then outputs a report listing the monetary equivalent in dollars, quar¬ 
ters, dimes, nickels, and pennies, as shown in the sample run. 

Your program should report the maximum number of dollars, then the number of quarters, 
dimes, nickels, and pennies, in this order, to result in the minimum number of coins. 

Here are the steps in developing the program: 

1. Prompt the user to enter the amount as a decimal number, such as 11.56. 

2. Convert the amount (11.56) into cents (1156). 

3. Divide the cents by 100 to find the number of dollars. Obtain the remaining cents using 
the cents remainder % 100 . 

4. Divide the remaining cents by 25 to find the number of quarters. Obtain the remaining 
cents using the remaining cents remainder % 2 5 . 
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5. Divide the remaining cents by 10 to find the number of dimes. Obtain the remaining 
cents using the remaining cents remainder % 10 . 

6. Divide the remaining cents by 5 to find the number of nickels. Obtain the remaining 
cents using the remaining cents remainder % 5. 

7. The remaining cents are the pennies. 

8. Display the result. 

The complete program is shown in Listing 3.4. 


Listing 3.4 ComputeChange.py 

1 # Receive the amount 

2 amount = evai (i nput("Enter an amount, for example, 11.56; ")) enterinput 

3 

4 # Convert the amount to cents 

5 remanningAmount = intfamount * 100) 

6 

7 # Find the number of one dollars 

8 numberOfOneDol 1 ars = remaini ngAmount // 100 dollars 

9 remainingAmount = remainingAmount % 100 
10 

11 # Find the number of quarters in the remaining amount 

12 numberOfQuarters = remai ni ngAmount // 25 quarters 

13 remainingAmount = remainingAmount % 25 

14 

15 # Find the number of dimes in the remaining amount 

16 numberOfDimes = remainingAmount // 10 dimes 

17 remainingAmount = remainingAmount % 10 

18 

19 # Find the number of nickels in the remaining amount 

20 numberOfNi ckel s = remai ni ngAmount // 5 nickels 

21 remainingAmount = remainingAmount % 5 

22 

23 # Find the number of pennies in the remaining amount 

24 numberOf Penni es = remai ni ngAmount pennies 

25 

26 # Display the results 

27 printC'Your amount", amount, "consists of\n", output 

28 "\t", numberOfOneDol1ars, "dollars\n", 

29 "\t", numberOfQuarters, "quarters\n" , 

30 "\t", numberOfDimes, 'dimes\n", 

31 "\t", numberOfNickels, "nickels\n", 

32 "\t", numberOfPennies, "pennies") 


Enter an amount, for example, 11.56: 11.56 Enter 
Your amount 11.56 consists of 
11 dollars 
2 quarters 
0 dimes 
1 nickels 
1 pennies 
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The variable amount stores the amount entered from the console (line 2). This variable is 
not changed, because the amount has to be used at the end of the program to display the 
results. The program introduces the variable remainingAmount (line 5) to store the chang¬ 
ing remainingAmount. 

The variable amount is a float representing dollars and cents. It is converted to an integer 
variable remainingAmount, which represents all the cents. For instance, if amount is 
11.56, then the initial remainingAmount is 1156. 1156 // 100 is 11 (line 8). The 
remainder operator obtains the remainder of the division. So, 1156 % 100 is 56 (line 9). 

The program extracts the maximum number of quarters from remainingAmount and 
obtains a new remainingAmount (lines 12-13). Continuing the same process, the program 
finds the maximum number of dimes, nickels, and pennies in the remaining amount. 

As shown in the sample run, 0 dimes, 1 nickels, and 1 pennies are displayed in the result. 
It would be better not to display 0 dimes, and to display 1 nickel and 1 penny using the sin¬ 
gular forms of the words. You will learn how to use selection statements to modify this pro¬ 
gram in the next chapter (see Exercise 4.7). 


loss of precision 



Caution 

One serious problem with this example is the possible loss of precision when converting a 
float amount to the integer remainingAmount. This could lead to an inaccurate result. If 
you try to enter the amount 10.03, 10.03 * 100 might be 1003.9999999999999. 
You will find that the program displays 10 dollars and 2 pennies. To fix the problem, enter 
the amount as an integer value representing cents (see Exercise 3.8). 


object 


V' (Point 


3.5 Introduction to Objects and Methods 

In Python, all data—including numbers and strings—are actually objects. 

In Python, a number is an object, a string is an object, and every datum is an object. Objects 
of the same kind have the same type. You can use the i d function and type function to get 
these pieces of information about an object. For example. 


1 

»> n = 3 # n 

is an integer 

2 

»> id(n) 


3 

505408904 


4 

»> type(n) 


5 

<class 'int'> 


6 

»> f = 3.0 # 

f is a float 
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7 »> id(f) 

8 26647120 

9 »> type(f) 

10 <class 'float'> 

11 »> s = "Welcome" # s is a string 

12 »> id(s) 

13 36201472 

14 »> type(s) 

15 <class 'str'> 

16 »> 


The id for the object is automatically assigned a unique integer by Python when the program 
is executed. The id for the object will not be changed during the execution of the program. 
However, Python may assign a different id every time the program is executed. The type for the 
object is determined by Python according to the value of the object. Line 2 displays the id for a 
number object n, line 3 shows the id Python has assigned for the object, and its type is dis¬ 
played in line 4. 

In Python, an object’s type is defined by a class. For example, the class for string is str 
(line 15), for integer is int (line 5), and for float is float (line 10). The term “class” comes 
from object-oriented programming, which will be discussed in Chapter 7. In Python, classes 
and types are synonymous. 

Note 

The id and type functions are rarely used in programming, but they are good tools for 
learning more about objects. 

A variable in Python is actually a reference to an object. Figure 3.2 shows the relationship 
between the variables and objects for the preceding code. 


n = 3 

id:505408904 

r*-►The object 

for int 3 


f = 3.0 

id:26647120 

f-►The object 

for float 
3.0 


s = "Welcome" 

id:36201472 

®-► The object 

for str 
"Welcome" 


Figure 3.2 In Python, each variable is actually a reference to an object. 


The statement n = 3 in line 1 assigns value 3 to n, which actually assigns 3 to an int 
object referenced by variable n. 

Note 

For n = 3, we say n is an integer variable that holds value 3. Strictly speaking, n is a variable 
that references an int object for value 3. For simplicity, it is fine to say n is an int variable 
with value 3. 

You can perform operations on an object. The operations are defined using functions. The 
functions for the objects are called methods in Python. Methods can only be invoked from a 
specific object. For example, the string type has the methods such as lowerC) and upperC), 



VideoNote 

String operations 


i d function 
type function 


objects vs. object reference 
variable 


methods 
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which return a new string in lowercase and uppercase. Here are some examples of how to 
invoke these methods: 


1 

»> s = "Welcome" 






2 

»> si = s.lowerO 

# 

Invoke 

the 

1 ower 

method 

3 

»> si 






4 

'welcome' 






5 

»> s2 = S.upperO 

# 

Invoke 

the 

upper 

method 

6 

»> s2 






7 

'WELCOME' 






8 

»> 








Line 2 invokes s .lower () on object s to return anew string in lowercase and assigns it to si. 
Line 5 invokes s. upper () on object s to return a new string in uppercase and assigns it to s2. 
As you can see from the preceding example, the syntax to invoke a method for an object is 

object.methodC) . 

stripO Another useful string method is stripC), which can be used to remove (strip) the 

whitespace characters from both ends of a string. The characters ' , \t, \f, \r, and \n are 
whitespace characters known as the whitespace characters. 

For example, 



»> s = "\t Welcome \n" 

»> si = s.strlpO # Invoke the strip method 

»> si 

'Welcome' 

»> 


Note 

If you use Python on Eclipse, Eclipse automatically appends \r in the string entered from 
the input function. Therefore, you should use the stripO method to remove the \r 
character as follows: 

s = inputC'Enter a string") .strip() 

More details on processing strings and on object-oriented programming will be discussed 
in Chapter 7. 



Python on Eclipse 


A 

W P( 


heck 

Point 


MyProgrammingLab" 


3.12 What is an object? What is a method? 

3.13 How do you find the id for an object? How do you find the type for an object? 

3.14 Which of the following statements is the precise meaning for the statement n 

(a) n is a variable that holds i nt value 3. 

(b) n is a variable that references an object that holds i nt value 3. 

3.15 Suppose s is "\tGeorgia\n". What is s.lowerC) and s.upperO? 

3.16 Suppose s is " \tGood\tMorning\n". What is s. stripO? 


3? 


^/Key 
^ / Point 


3.6 Formatting Numbers and Strings 

You can use the formaX. function to return a formatted string. 

Often it is desirable to display numbers in a certain format. For example, the following code 
computes interest, given the amount and the annual interest rate. 
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»> amount = 12618.98 
»> 1 nterestRate = 0.0013 
»> interest = amount * interestRate 
»> printC'Interest is", interest) 
Interest is 16.404674 
»> 



Because the interest amount is currency, it is desirable to display only two digits after the 
decimal point. To do this, you can write the code as follows: 


»> amount = 12618.98 
»> interestRate = 0.0013 
»> interest = amount * interestRate 
»> pri ntC'Interest is", roundfi nterest, 2)) 
Interest is 16.4 
»> 


However, the format is still not correct. There should be two digits after the decimal point 
like 16.40 rather than 16.4. You can fix it by using the format function, like this: format 


»> amount = 12618.98 
»> interestRate = 0.0013 
»> interest = amount * interestRate 
»> pri ntC'Interest is", formatfi nterest, ".2f")) 
Interest is 16.40 
»> 


The syntax to invoke this function is 
format(item, format-specifier) 

where item is a number or a string and format-speci fier is a string that specifies how the 
item is formatted. The function returns a string. 


3.6.1 Formatting Floating-Point Numbers 

If the item is a float value, you can use the specifier to give the width and precision of the 
format in the form of width, precisionf. Here, width specifies the width of the resulting 
string, precision specifies the number of digits after the decimal point, and f is called the 
conversion code, which sets the formatting for floating point numbers. For example. 


print(format (57. 467657, "10. 2f")) 
print(format (12345678.923, "10. 2f")) 
print(format(57.4, "10. 2f")) 
print(format(57, "10. 2f")) 

displays 




format specifier 
field width conversion code 


precision 


conversion code 


I I I I I I 57.47 
123456782.92 

. 57.40 

. 57.00 


where a square box (□) denotes a blank space. Note that the decimal point is counted as one 
space. 
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The formatC'lO. 2f") function fomats the number into a string whose width is 10, includ¬ 
ing a decimal point and two digits after the point. The number is rounded to two decimal places. 
Thus there are seven digits allocated before the decimal point. If there are fewer than seven digits 
before the decimal point, spaces are inserted before the number. If there are more than seven 
digits before the decimal point, the number’s width is automatically increased. For example, 
formatC12345678.923, "10.2f") returns 12345678.92, which has a width of 11. 

You can omit the width specifier. If so, it defaults to 0. In this case, the width is automati¬ 
cally set to the size needed for formatting the number. For example, 

print(format (57. 467657, "10. 2f")) 
print(format (57. 467657, ".2f")) 

displays 



3.6.2 Formatting in Scientific Notation 

If you change the conversion code from f to e, the number will be formatted in scientific 
notation. For example, 

print(format (57.467657 , "10.2e'’)) 
print(format (0.0033923 , "10.2e')) 
print(format(57.4, "10.2e")) 
print(format(57, "10.2e")) 

displays 


m 5.756-^01 
m 3.39e-03 
m 5.74e-t01 
m 5.70e-i-01 


The -I- and signs are counted as places in the width limit. 

3.6.3 Formatting as a Percentage 

You can use the conversion code % to format a number as a percentage. For example, 

print(format (0.53457, "10.2%")) 
pri nt(format(0. 0033923, "10.2%")) 
print(format(7.4, "10.2%")) 
print(format(57, "10.2%")) 

displays 


rrm 53.46% 

. 0.34% 

cm 740.00% 
m 5700.00% 

The format 10.2% causes the number to be multiplied by 100 and displayed with a % sign 
following it. The total width includes the % sign counted as one space. 
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3.6.4 Justifying Format 

By default, the format of a number is right justified. You can put the symbol < in the format 
specifier to specify that the item be left-justified in the resulting format within the specified 
width. For example, 

print(format (57. 467657, "10. 2f")) 
print(format (57. 467657, "<10.2f”)) 

displays 



3.6.5 Formatting Integers 

The conversion codes d, x, o, and b can be used to format an integer in decimal, hexadecimal, 
octal, or binary. You can specify a width for the conversion. For example, 

print(format(59832, "lOd")) 
print(format(59832, "<10d")) 
print(format(59832, "lOx")) 
print(format(59832, "<10x")) 

displays 


H—10—H 

I I I I I I 59832 
59832 

. . 

e9b8 

The format specifier lOd specifies that the integer is formatted into a decimal with a width 
of ten spaces. The format specifier lOx specifies that the integer is formatted into a hexadeci¬ 
mal integer with a width of ten spaces. 


3.6.6 Formatting Strings 

You can use the conversion code s to format a string with a specified width. For example, 

print(format("Welcome to Python", "20s")) 
print(format("Welcome to Python", "<20s")) 
print(format("Welcome to Python", ">20s")) 
pri nt(format("Wel come to Python and Java", ">20s'’)) 

displays 


Welcome to Python 
Welcome to Python 
cm Welcome to Python 
Welcome to Python and Java 

The format specifier 20s specifies that the string is formatted within a width of 20. By 
default, a string is left justified. To right-justify it, put the symbol > in the format specifier. If 
the string is longer than the specified width, the width is automatically increased to fit the 
string. 

Table 3.4 summarizes the format specifiers introduced in this section. 
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Table 3.4 Frequently Used Specifiers 

Specifier Format 


"10.2f" 
"10.2e" 
"5d" 

"5x" 

"So" 

"5b" 

" 10 . 2 %" 

"50s" 

"<10.2f” 

">10.2f" 


Format the float item with width 10 and precision 2. 

Format the float item in scientific notation with width 10 and precision 2. 
Format the integer item in decimal with width 5. 

Format the integer item in hexadecimal with width 5. 

Format the integer item in octal with width 5. 

Format the integer item in binary with width 5. 

Format the number in decimal. 

Format the string item with width 50. 

Left-justify the formatted item. 

Right-justify the formatted item. 


/Check 

Point 

MyProgrammingLab" 


3.17 

3.18 

3.19 


What is the return value from invoking the format function? 

What happens if the size of the actual item is greater than the width in the format 
specifier? 

Show the printout of the following statements: 


print(format (57.467657, "9.3f")) 
print(format (12345678.923, "9.If")) 
print(format(57.4, ".2f")) 
print(format(57.4, "10.2f")) 


3.20 Show the printout of the following statements: 

print(format (57 .467657 , "9.3e' )) 
print(format (12 345678.923 , "9. le')) 
print(format(57.4, ".2e")) 
print(format(57.4, "10. 2e'')) 


3.21 Show the printout of the following statements: 

print(format (5789.467657, "9.3f")) 
print(format (5789.467657, "<9.3f")) 
print(format(5789.4, ".2f")) 
print(format(5789.4, "<.2f")) 
print(format (5 789.4, ">9.2f")) 


3.22 Show the printout of the following statements: 

print(format(0 .457467657 , "9.3%' )) 
print(format (0.45746765 7, "<9. 3%")) 


3.23 Show the printout of the following statements: 

print(format(45, "5d")) 
print(format(45, "<5d")) 
print(format(45, "5x")) 
print(format(45, "<5x")) 


3.24 Show the printout of the following statements: 

pri nt(format("Programming is fun", "25s")) 
pri nt(format("Programming is fun", "<25s")) 
pri nt(format("Programming is fun", ">25s")) 
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3.7 Drawing Various Shapes 

The Python turtl e module contains methods for moving the pen, setting the pen’s 
size, lifting, and putting down the pen. 


^/Key 
P / Point 


Chapter 1 introduced drawing with the turtle. A turtle is actually an object that is created 
when you import the turtl e module. You then invoke the turtle object’s methods to perform 
operations. This section introduces more methods for the turtl e object. 

When a turtle object is created, its position is set at (0, 0) —the center of the window—and 
its direction is set to go straight to the right. The turtl e module uses a pen to draw shapes. 
By default, the pen is down (like the tip of an actual pen touching a sheet of paper). When you 
move the turtle, it draws a line from the current position to the new position if the pen is down. 
Table 3.5 lists the methods for controlling the pen’s drawing state; Table 3.6 lists the methods 
for moving the turtle. 


turtle’s position and direction 
turtle’s pen 



VideoNote 

Draw shapes 


Table 3.5 Turtle Pen Drawing State Methods 

Method Description 

turtl e. pendownO Pulls the pen down—drawing when moving, 

turtl e. penupO Pulls the pen up—no drawing when moving, 

turtle.pensizeCwidth) Sets the line thickness to the specified width. 


Table 3.6 Turtle Motion Methods 

Method Description 


turtle.forward(d) 
turtle.backward(d) 

turtle, right(angle) 

turtle.1eft(angle) 

turtle.gotofx, y) 

turtle.setx(x) 

turtle.setyCy) 

turtle.setheading(angle) 

turtle, home C) 

turtle.circle(r, ext, step) 
turtle.dot(diameter, color) 
turtl e.undoO 
turtle.speed(s) 


Moves the turtle forward by the specified distance in the direction the turtle is headed. 

Moves the turtle backward by the specified distance in the opposite direction the turtle is 
headed. The turtle’s direction is not changed. 

Turns the turtle right by the specified angle. 

Turns the turtle left by the specified angle. 

Moves the turtle to an absolute position. 

Moves the turtle’s x-coordinate to the specified position. 

Moves the turtle’s y-coordinate to the specified position. 

Sets the orientation of the turtle to a specified angle. 0-East, 90-North, 180-West, 270-South. 
Moves the turtle to the origin (0, 0) and east direction. 

Draws a circle with the specified radius, extent, and step. 

Draws a circle with the specified diameter and color. 

Undo (repeatedly) the last turtle action(s). 

Sets the turtle’s speed to an integer between 1 and 10, with 10 being the fastest. 


All these methods are straightforward. The best way to learn them is to write a test code to 
see how each method works. 

The ci rcl e method has three arguments: The radius is required, and extent and step 
are optional, extent is an angle that determines which part of the circle is drawn, step 
determines the number of steps to use. If step is 3, 4, 5, 6, ..., the ci rcl e method will draw 
a maximum regular polygon with three, four, five, six, or more sides enclosed inside the cir¬ 
cle (that is, a triangle, square, pentagon, hexagon, etc.). If step is not specified, the ci rcl e 
method will draw a circle. 
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import turtle module 

set pen size 
penup 
move pen 
pendown 
draw a triangle 


pause 


iCheck 
W Point 

MyProgrammingLab" 


Listing 3.5 shows sample code for drawing a triangle, a square, a pentagon, a hexagon, and 
a circle, as shown in Figure 3.3. 



Figure 3.3 The program draws five shapes. 


Listing 3.5 Si mpl eShapes. py 

1 import turtle 

2 

3 turtle.pensize(3) # Set pen thickness to 3 pixels 

4 turtle.penupO # Pull the pen up 

5 turtle. goto(-200, -50) 

6 turtle.pendownO # Pull the pen down 

7 turtle.ci rcle(40, steps = 3) # Draw a triangle 

8 

9 turtl e. penupO 

10 turtle. goto(-100, -50) 

11 turtl e. pendownO 

12 turtle.ci rcle(40, steps = 4) # Draw a square 

13 

14 turtl e. penupO 

15 turtle. gotoCO, -50) 

16 turtl e. pendownO 

17 turtle.ci rcle(40, steps = 5) # Draw a pentagon 

18 

19 turtl e. penupO 

20 turtle. gotoClOO, -50) 

21 turtl e. pendownO 

22 turtle.ci rcle(40, steps = 6) # Draw a hexagon 

23 

24 turtl e. penupO 

25 turtle. gotoC200, -50) 

26 turtl e. pendownO 

27 turtle.circl e(40) # Draw a circle 

28 

29 turtle.doneO 


Line 1 imports the turtle module. Line 3 sets the pen’s thickness to 3 pixels. Line 4 pulls 
the pen up so that you can reposition it to (-200, - 50) in line 5. Line 6 puts the pen down to 
draw a triangle in line 7. In line 7, the turtle object invokes the circle method with a 
radius of 40 and 3 steps to draw a triangle. Similarly, the rest of the program draws a square 
(line 12), a pentagon (line 17), a hexagon (line 22), and a circle (line 27). 

3.25 How do you set the turtle to its original position (0, 0)? 

3.26 How do you draw a red dot with diameter 3? 

3.27 What figure will the following method draw? 
turtle.circl e(50 , step = 4) 
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3.28 How do you make the turtle move fast? 

3.29 How do you undo the turtle’s last action? 


3.8 Drawing with Colors and Fonts 

A turtle object contains the methods for setting colors and fonts. 

The preceding section showed you how to draw shapes with the turtl e module. You learned 
how to use the motion methods to move the pen and use the pen methods to raise the pen up, 
set it down, and control its thickness. This section introduces more pen control methods and 
shows you how to set colors and fonts and write text. 

Table 3.7 lists the pen methods for controlling drawing, color, and filling. Listing 3.6 is a 
sample program that draws a triangle, a square, a pentagon, a hexagon, and a circle in differ¬ 
ent colors, as shown in Figure 3.4. The program also adds text to the drawing. 


Key 

Point 


Table 3.7 Turtle Pen Color, Filling, and Drawing Methods 

Method Description 


turtle, col or (c) 
turtle.fincolor(c) 
turtle.begin„fin () 
turtle.end_fin () 
turtle.fillingO 
turtle.clearO 
turtle. resetO 
turtle.screensizeCw, h) 
turtle.hideturtleO 
turtle. showturtleO 
turtle. 1 svi si ble() 

turtle.write(s, font=("Arial", 
8, "normal")) 


Sets the pen color. 

Sets the pen fill color. 

Calls this method before filling a shape. 

Fills the shapes drawn before the last call to begi n_f i 11 . 

Returns the fill state: True if filling, Fal se if not filling. 

Clears the window. The state and the position of the turtle are not affected. 
Clears the window and reset the state and position to the original default value. 
Sets the width and height of the canvas. 

Makes the turtle invisible. 

Makes the turtle visible. 

Returns True if the turtle is visible. 

Writes the string s on the turtle position. Font is a triple consisting of fontname, 
fontsize, and fonttype. 


Listing 3.6 ColorShapes.py 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 
17 


import turtle 


turtle.pens! zeC3) # Set pen thickness to 3 pixels 

turtle.penupO # Pull the pen up 

turtle. goto(-200, -50) 

turtle.pendownO # Pull the pen down 

turtle.begin_fi11() # Begin to fill color in a shape 

turtl e. colorC'red' ) 

turtle.ci rcle(40, steps = 3) # Draw a triangle 
turtle.end_fi11() # Fill the shape 


turtl e. penupO 
turtle. goto(-100, -50) 
turtl e. pendownO 

turtle.begin_fi11O # Begin to fill color in a shape 
turtle.col or ("blue") 

turtle.ci rcle(40, steps = 4) # Draw a square 


import turtle module 

set pen size 
penup 
move pen 
pendown 
begin_fi11 
set a color 
draw a triangle 

end_fi11 




84 Chapter 3 Mathematical Functions, Strings, and Objects 


write text 


pause 


18 

turtle.end_fii1() # Fiii the shape 




19 





20 

turtl e. penupO 




21 

turtle. gotoCO, -50) 




22 

turtl e. pendownO 




23 

turtle.begin_fi11() # Begin to fill 

color 

i n a 

shape 

24 

turtl e . colorCgreen") 




25 

turtle.ci rcle(40, steps = 5) # Draw 

a pentagon 


26 

turtle.end_fi11() # Fill the shape 




27 





28 

turtl e. penupO 




29 

turtle. gotoClOO, -50) 




30 

turtl e. pendownO 




31 

turtle.begin_fi11O # Begin to fill 

color 

i n a 

shape 

32 

turtle.col or ("yellow") 




33 

turtle.ci rcle(40, steps = 6) # Draw 

a hexagon 


34 

turtle.end_fi11 O # Fill the shape 




35 





36 

turtl e. penupO 




37 

turtle. gotoC200, -50) 




38 

turtl e. pendownO 




39 

turtle.begin_fi11O # Begin to fill 

color 

i n a 

shape 

40 

turtle.col or ("purple") 




41 

turtle.circl e(40) # Draw a circle 




42 

turtle.end_fi11() # Fill the shape 




43 

turtl e .col or ("green") 




44 

turtl e. penupO 




45 

turtle. goto(-100, 50) 




46 

turtl e. pendownO 




47 

turtle.write ("Cool Colorful Shapes", 




48 

font = ("Times", 18, "bold')) 




49 

turtle.hideturtle() 




50 





51 

turtle.doneO 






Figure 3.4 The program draws five shapes in different colors. 


The program is similar to Listing 3.5. SimpleShapes.py, except that it fills each shape with 
a color and writes a string. The turtle object invokes the begin_fin () method in line 7 to 
tell Python to draw shapes filled with color. A triangle is drawn in line 9. Invoking the 
end.fillQ method (line 10) completes the color filling for the shape. 

The write method writes a string with the specified font at the current pen position (lines 
47-48). Note that drawing takes place when the pen is moved if the pen is down. To avoid 
drawing, you need to pull the pen up. Invoking hideturtleC) makes the turtle invisible 
(line 49) so you will not see the turtle in the window. 
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3.30 How do you set the turtle’s color? 

3.31 How do you fill a shape with color? 

3.32 How do you make the turtle invisible? 

Key Terms 

backslash (\) 69 

character encoding 68 
end-of-line 69 
escape sequence 69 
line break 69 

Chapter Summary 

1 . Python provides the mathematical functions abs, max, min, pow, and round in the 
interpreter and the functions fabs, ceil, floor, exp, log, sqrt, sin, asin, cos, 
acos, tan, degrees, and radians in the math module. 

2. A string is a sequence of characters. String values can be enclosed in matching single 
quotes ( ) or double quotes ("). Python does not have a data type for characters; a 
single-character string represents a character. 

3. An escape sequence is a special syntax that begins with the character \ followed by a 
letter or a combination of digits to represent special characters, such as \ ', \", \t, 
and \n. 

4. The characters ' ', \t, \f, \r, and \n are known as the whitespace characters. 

5. All data including numbers and strings are objects in Python. You can invoke 
methods to perform operations on the objects. 

6. You can use the format function to format a number or a string and return the result 
as a string. 

Test Questions 

Do test questions for this chapter online at www.cs.armstrong.edu/liang/py/test.html. 

Programming Exercises MyProgrammingLab" 

Section 3.2 

3.1 (Geometry: area of a pentagon) Write a program that prompts the user to enter the 
length from the center of a pentagon to a vertex and computes the area of the pen¬ 
tagon, as shown in the following figure. 


methods 75 
newline 69 
object 74 
string 67 

whitespace characters 76 
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The formula for computing the area of a pentagon is Area 


3V3 

2 


where s is 

77 


the length of a side. The side can be computed using the formula s = 2r sin —, 

where r is the length from the center of a pentagon to a vertex. Here is a sample 
run: 



Enter the length from the center to a vertex: 5.5 |^enter 
The area of the pentagon is 108.61 


*3.2 (Geometry: great circle distance) The great circle distance is the distance between 
two points on the surface of a sphere. Let (xl, }'l) and (x2, y2) be the geographical 
latitude and longitude of two points. The great circle distance between the two 
points can be computed using the following formula: 

d = radius X arccos(sin(x p X sin(x 2 ) + cos(xj) X cos(x 2 ) X cos(yi — J2)) 

Write a program that prompts the user to enter the latitude and longitude of two 
points on the earth in degrees and displays its great circle distance. The average 
earth radius is 6,371.01 km. Note that you need to convert the degrees into radians 
using the math. radians function since the Python trigonometric functions use 
radians. The latitude and longitude degrees in the formula are for north and west. 
Use negative to indicate south and east degrees. Here is a sample run: 



Enter point 1 (latitude and longitude) in degrees: 

39.55, -116.25 banter | 

Enter point 2 (latitude and longitude) in degrees: 

41.5, 87.37 

The distance between the two points is 10691.79183231593 km 


*3.3 (Geography: estimate areas) Find the GPS locations for Atlanta, Georgia; 

Orlando, Florida; Savannah, Georgia; and Charlotte, North Carolina from 
www.gps-data-team.com/map/ and compute the estimated area enclosed by these 
four cities. (Hint: Use the formula in Programming Exercise 3.2 to compute the 
distance between two cities. Divide the polygon into two triangles and use the for¬ 
mula in Programming Exercise 2.14 to compute the area of a triangle.) 

3.4 (Geometry: area of a pentagon) The area of a pentagon can be computed using the 
following formula (s is the length of a side): 

5 X s^ 

Area = 

4 X tan| 

Write a program that prompts the user to enter the side of a pentagon and displays 
the area. Here is a sample run: 



Enter the side: 5.5 

The area of the pentagon is 53.04444136781625 
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*3.5 {Geometry: area of a regular polygon) A regular polygon is an n-sided polygon in 

which all sides are of the same length and all angles have the same degree (i.e., the 
polygon is both equilateral and equiangular). The formula for computing the area 
of a regular polygon is 

n X 

Area = - 

4 X tan| 

Here, s is the length of a side. Write a program that prompts the user to enter the 
number of sides and their length of a regular polygon and displays its area. Here is 
a sample run: 


Enter the number of sides: 5 [ -I Enter | 

Enter the side: 6.5 [ -I Enter | 

The area of the polygon is 73.69017017488385 


Sections 3.3-3.6 

*3.6 (Find the character of an ASCII code) Write a program that receives an ASCII 
code (an integer between 0 and 127) and displays its character. For example, if the 
user enters 97, the program displays the character a. Here is a sample run: 


Enter an ASCII code: 

69 1 Enter^ 

The character is E 




3.7 {Random character) Write a program that displays a random uppercase letter 
using the time.timeC) function. 

*3.8 {Financial application: monetary units) Rewrite Listing 3.4, ComputeChange.py, 
to fix the possible loss of accuracy when converting a float value to an int value. 
Enter the input as an integer whose last two digits represent the cents. For exam¬ 
ple, the input 1156 represents 11 dollars and 56 cents. 

*3.9 {Financial application: payroll) Write a program that reads the following infor¬ 
mation and prints a payroll statement: 

Employee’s name (e.g.. Smith) 

Number of hours worked in a week (e.g., 10) 

Hourly pay rate (e.g., 9.75) 

Federal tax withholding rate (e.g., 20%) 

State tax withholding rate (e.g., 9%) 

A sample run is shown below: 


Enter employee's name: Smith enter] 

Enter number of hours worked in a week: 10 |^enter| 
Enter hourly pay rate: 9.75 |^enter | 

Enter federal tax withholding rate: 0.20 (center| 
Enter state tax withholding rate: 0.09 |^enter| 

Employee Name: Smith 
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Hours Worked: 10.0 
Pay Rate: $9.75 
Cross Pay: $97.5 
Deductions: 

Federal Withholding (20.0%): $19.5 
State Withholding (9.0%): $8.77 
Total Deduction: $28.27 
Net Pay: $69.22 


*3.10 {Turtle: display Unicodes) Write a program to display Greek letters ajSySe^rjO. 

The Unicode of these characters are \u03bl \u03b2 \u03b3 \u03b4 \u03b5 
\u03b6 \u03b7 \u03b8. 

3.11 {Reverse number) Write a program that prompts the user to enter a four-digit inte¬ 
ger and displays the number in reverse order. Here is a sample run: 



Enter an integer: 3125 
The reversed number is 5213 


Sections 3.7-3.8 

**3.12 {Turtle: draw a star) Write a program that prompts the user to enter the length of 
the star and draw a star, as shown in Figure 3.5a. (Hint: The inner angle of each 
point in the star is 36 degrees.) 



Figure 3.5 The program (a) draws a star, (b) displays a STOP sign, and (c) draws an Olympic symbol. 


*3.13 {Turtle: display a STOP sign) Write a program that displays a STOP sign, as 
shown in Figure 3.5b. The hexagon is in red and the text is in white. 

3.14 {Turtle: draw the Olympic symbol) Write a program that prompts the user to 
enter the radius of the rings and draws an Olympic symbol of five rings of the 
same size with the colors blue, black, red, yellow, and green, as shown in 
Figure 3.5c. 

*3.15 {Turtle: paint a smiley face) Write a program that paints a smiley face, as shown in 
Figure 3.6a. 
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Figure 3.6 The program paints a smiley face in (a) and draws five shapes with bottom edges parallel to the x-axis in (b). 


**3.16 {Turtle: draw shapes) Write a program that draws a triangle, square, pentagon, 
hexagon, and octagon, as shown in Figure 3.6b. Note that the bottom edges of 
these shapes are parallel to the x-axis. (Hint: For a triangle with a bottom line 
parallel to the x-axis, set the turtle’s heading to 60 degrees.) 

*3.1 7 {Turtle: triangle area) Write a program that prompts the user to enter the three 
points pi, p2, and p3 for a triangle and display its area below the triangle, as 
shown in Figure 3.7a. The formula for computing the area of a triangle is given 
in Exercise 2.14. 




Python Turtle Graphics 't— 
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(a) (b) (c) 

Figure 3.7 The program displays (a) the area of the triangle and (b) the angles for the triangle, (c) The program draws 
a line. 


*3.18 {Turtle: triangle angles) Revise Listing 3.2, ComputeAngles.py, to write a pro¬ 
gram that prompts the user to enter the three points pi, p2, and p3 for a triangle 
and display its angles, as shown in Figure 3.7b. 

**3.19 {Turtle: draw a line) Write a program that prompts the user to enter two points 
and draw a line to connect the points and displays the coordinates of the points, 
as shown in Figure 3.7c. 
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CHAPTER 


4 

Selections 

objectives 

■ To write Boolean expressions using comparison operators (§4.2). 

■ To generate random numbers using the random. randi nt (a , b) or 

random, random () functions (§4.3). 

■ To program with Boolean expressions (AdditionQuiz) (§4.3). 

■ To implement selection control using one-way 1 f statements (§4.4). 

■ To program with one-way i f statements (CuessBi rthday) (§4.5). 

■ To implement selection control using two-way i f-el se statements (§4.6). 

■ To implement selection control with nested i f and multi-way 
i f-el i f-el se statements (§4.7). 

■ To avoid common errors in i f statements (§4.8). 

■ To program with selection statements (§§4.9-4.10). 

■ To combine conditions using logical operators (and, or, and not) (§4.11). 

■ To use selection statements with combined conditions (LeapYear, 

Lottery) (§§4.12-4.13). 

■ To write expressions that use the conditional 
expressions (§4.14). 

■ To understand the rules governing operator precedence 
and associativity (§4.15). 

■ To detect the location of an object (§4.16). 
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4.1 Introduction 

A program can decide which statements to execute based on a condition. 

If you enter a negative value for radius in Listing 2.2, ComputeAreaWithConsoleInput.py, 
the program displays an invalid result. If the radius is negative, the program cannot compute 
the area. How can you deal with this situation? 

Like all high-level programming languages. Python provides selection statements that let 
you choose actions with two or more alternative courses. You can use the following selection 
statement to replace line 5 in Listing 2.2: 

if radius < 0: 

pri ntC'Incorrect input") 
el se: 

area = radius * radius * math.pi 
printC'Area is", area) 

Boolean expressions Selection statements use conditions, which are Boolean expressions. This chapter introduces 

Boolean types, values, comparison operators, and expressions. 


Y ) Point 

problem 

selection statements 


Key 

Point 


4.2 Boolean Types, Values, and Expressions 

A Boolean expression is an expression that evaluates to a Boolean value True or 
Fal se. 


comparison operators 



VideoNote 

Boolean expressions 


How do you compare two values, such as whether a radius is greater than 0, equal to 0, or less 
than 0? Python provides six comparison operators (also known as relational operators), 
shown in Table 4.1, which an be used to compare two values (the table assumes that a radius 
of 5 is being used). 


Table 4.1 

Comparison Operators 



Python 

Mathematics 


Example 


Operator 

Symbol 

Name 

(radius is 5) 

Result 

< 

< 

less than 

radius < 0 

Fal se 

<= 

< 

less than or equal to 

radius <= 0 

Fal se 

> 

> 

greater than 

radius > 0 

True 

> = 

> 

greater than or equal to 

radius >= 0 

True 

== 

= 

equal to 

radius == 0 

Fal se 

! = 


not equal to 

radius != 0 

True 



Caution 

The equal to comparison operator is two equal signs ( ), not a single equal sign ( ). 

The latter symbol is for assignment. 


Boolean value 


The result of the comparison is a Boolean value: True or Fal se. For example, the follow¬ 
ing statement displays the result True: 


radius = 1 
print(radius > 0) 
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A variable that holds a Boolean value is known as a Boolean variable. The Boolean data Boolean variable 
type is used to represent Boolean values. A Boolean variable can hold one of the two values: 

True or Fal se. For example, the following statement assigns the value True to the variable 

lightsOn: 

lightsOn = True 

True and Fal se are literals, just like a number such as 10. They are reserved words and 
cannot be used as identifiers in a program. 

Internally, Python uses 1 to represent True and 0 for Fal se. You can use the i nt function 
to convert a Boolean value to an integer. 

For example, 

pri nt(i nt(True)) 
displays 1 and 

pri nt(i nt(False)) 
displays 0. 

You can also use the bool function to convert a numeric value to a Boolean value. The bool function 
function returns Fal se if the value is 0; otherwise, it always returns True. 

For example, 

print(bool (0)) 
displays Fal se and 

print(bool (4)) 
displays True. 

4 -1 List six comparison operators. 

4*2 Can the following conversions be allowed? If so, find the converted result 
i = int(True) 
j = int (False) 

bl = bool (4) 
b2 = bool (0) 


4.3 Generating Random Numbers 

The randi nt (a, b) function can be used to generate a random integer between 
and b, inclusively. 

Suppose you want to develop a program to help a first grader practice addition. The 
program randomly generates two single-digit integers, numberl and numberZ, and dis¬ 
plays to the student a question such as What is 1 -t- 7, as shown in Listing 4.1. After the 
student types the answer, the program displays a message to indicate whether it is true 
or false. 

To generate a random number, you can use the randi nt (a, b) function in the random 
module. This function returns a random integer i between a and b, inclusively. To obtain a 
random integer between 0 and 9, use randi nt (0, 9) . 
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The program may be set up to work as follows: 

Step 1: Generate two single-digit integers for numberl (e.g., 4) and numberZ (e.g., 5) 
Step 2: Prompt the student to answer, "What is 4 + 5?" 

Step 3: Check whether the student’s answer is correct. 


import random module 


generate numberl 
generate number2 


show question 


display result 


Listing 4*1 AdditionQuiz.py 

1 import random 

2 

3 # Generate random numbers 

4 numberl = random.randi nt(0, 9) 

5 numberZ = random.randi nt(0, 9) 

6 

7 # Prompt the user to enter an answer 

8 answer = evai(i nput("What is " + str(numberl) + " + " 

9 + strfnumberZ) + "? ' )) 

10 

11 # Display result 

12 printfnumberl, numberZ, , answer, 

13 "is", numberl + numberZ == answer) 


Ov 


What is 1 + 7? 8 
1+7 = 8 isT rue 


What is 4 + 8? 9 
4 + 8 = 9 is False 


line# 

numberl 

numberZ 

answer 

output 

4 

4 




5 


8 



8 



9 


12 




4 + 8 = 9 is False 


random module 


rand range function 


random function 


The program uses the randint function defined in the random module. The import 
statement imports the module (line 1). 

Lines 4—5 generate two numbers, numberl and numberZ. Line 8 obtains an answer from the 
user. The answer is graded in line 12 using a Boolean expression numberl + numberZ == 
answer. 

Python also provides another function, rand range (a, b), for generating a random inte¬ 
ger between a and b - 1, which is equivalent to randi nt (a, b - 1). For example, 
randrangeCO, 10) and randint(0, 9) are the same. Since randi nt is more intuitive, the 
book generally uses randi nt in the examples. 

You can also use the random () function to generate a random float r such that 0 <= r < 
1.0. For example 


random. randomO 
random. randomO 
random.randint(a, b) 



1 >» import random 

2 >» random. randomO 

3 0.34343 

4 »> random. randomO 

5 0.20119 

6 »> random. randi nt(0, 1) 
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7 

0 


8 

»> 

random.randint(0, 1) 

9 

1 


10 

»> 

random.randrange(0, 1) # This will always be 0 

11 

0 


12 

»> 



Invoking random. random () (lines 2 and 4) returns a random float number between 0 . 0 and 
1.0 (excluding 1.0). Invoking random. randint(0, 1) (lines 6 and 8) returns 0 or 1. 
Invoking random. randrange(0, 1) (line 10) always returns 0. 

4*3 How do you generate a random integer i such that Q < i < 20? 

4*4 How do you generate a random integer i such that 10 s i < 20? 

4-5 How do you generate a random integer ' such that 10 s i s 50? 

4-6 How do you generate a random integer 0 or 1? 

4-4 "i f Statements 

A one-way if statement executes the statements if the condition is true. 

The preceding program displays a message such as 6 + 2 = 7 is Fal se. If you wish the 
message to be 6 + 2 = 7 is incorrect, you have to use a selection statement to make 
this minor change. 

Python has several types of selection statements: one-way if statements, two-way if- 
el se statements, nested i f statements, multi-way i f-el i f-el se statements and conditional 
expressions. This section introduces one-way i f statements. 

A one-way i f statement executes an action if and only if the condition is true. The syntax 
for a one-way i f statement is: 
if boolean-expression: 

statement(s) # Note that the statement(s) must be indented 

The statement(s) must be indented at least one space to the right of the if keyword 
and each statement must be indented using the same number of spaces. For consistency, we 
indent it four spaces in this book. 

The flowchart in Figure 4.1a illustrates how Python executes the syntax of an if state¬ 
ment. A flowchart is a diagram that describes an algorithm or process, showing the steps as 
boxes of various kinds, and their order by connecting these with arrows. Process operations 
are represented in these boxes, and arrows connecting them show flow of control. A diamond 
box is used to denote a Boolean condition and a rectangle box is for representing statements. 

If the boolean-expression evaluates to true, the statements in the if block are exe¬ 
cuted. The i f block contains the statements indented after the i f statement. For example: 
if radius >= 0: 

area = radius * radius * math.pi 

printC'The area for the circle of radius", radius, "is", area) 

The flowchart of the preceding statement is shown in Figure 4.1b. If the value of radius 
is greater than or equal to 0 , then the area is computed and the result is displayed; otherwise, 
these statements in the block are not executed. 

The statements in the i f block must be indented in the lines after the i f line and each 
statement must be indented using the same number of spaces. For example, the following 
code is wrong, because the print statement in line 3 is not indented using the same number 
of spaces as the statement for computing area in line 2. 

1 if radius >= 0: 

2 area = radius * radius * math.pi # Compute area 

3 printC'The area for the circle of radius", radius, "is", area) 


random.randrangeCa, b) 
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boolean- false 



(a) 



(b) 


Figure 4-1 An i f statement executes statements if the bool ean-expression evaluates 
to True. 


Listing 4.2 is an example of a program that prompts the user to enter an integer. If the num¬ 
ber is a multiple of 5, the program displays the result Hi Fi ve. If the number is divisible by 2, 
the program displays Hi Even. 



Listing 4.2 Si mpl elf Demo. 

enter input 

1 

7 

number = eval(i nputC'Enter an 

check 5 

L 

3 

if number % 5 == 0 : 


4 

C 

pri ntC'HiFive") 

check even 

J 

6 

if number % 2 == 0: 


7 

printC'HiEven'') 


py 

integer: 


)) 



Enter an 
Hi Even 

integer: 

4 1 ^ Enter | 


Enter an 
Hi Five 

Hi Even 

integer: 

30 I'-i Enter | 


/Check 
V Point 

MyProgrammingLab" 


V' / Point 


The program prompts the user to enter an integer (line 1) and displays Hi Five if it is divis¬ 
ible by 5 (lines 3-4) and Hi Even if it is divisible by 2 (lines 6-7). 

4-7 Write an i f statement that assigns 1 to x if y is greater than 0. 

4-8 Write an i f statement that increases pay by 3% if score is greater than 90. 

4.5 Case Study: Guessing Birthdays 

Guessing birthdays is an interesting problem with a simple program solution. 

You can find out the date of the month when your friend was born by asking five questions. 
Each question asks whether the day is in one of the five sets of numbers. 
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+ 


m 

3 

5 

7 

s 

3 

6 

7 

4 

5 

6 

7 

8 

9 

10 
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17 
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14 

15 

12 

13 

14 

15 

12 

13 

14 

15 

20 

21 

22 
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17 

19 
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18 

19 

22 

23 

20 

21 

22 

23 

24 

25 

26 

27 

24 

25 

26 

27 

25 

27 

29 

31 

26 

27 

30 

31 

28 

29 

30 

31 

28 

29 

30 

31 

28 

29 

30 

31 


Sell 


Set2 


Sets 


Set4 


Sets 


The birthday is the sum of the first numbers in the sets where the date appears. For exam¬ 
ple, if the birthday is 19, it appears in Setl, Set2, and Set5. The first numbers in these three 
sets are 1, 2, and 16. Their sum is 19. 

Listing 4.3 is a program that prompts the user to answer whether the day is in Setl (lines 
4—13), in Set2 (lines 16-25), in Set3 (lines 28-37), in Set4 (lines 40-49), or in Set5 (lines 
52-61). If the number is in the set, the program adds the first number in the set to day (lines 13, 

25, 37, 49, and 61). 

Listing 4*3 GuessBi rthday. py 

1 day = 0 # birth day to be determined day to be determined 

2 

3 # Prompt the user to answer the first question 

4 questionl = "Is your birthday in Setl?\n" + \ inquestionl? 

5 135 7\n" + \ 

6 " 9 11 13 15\n" + \ 

7 "17 19 21 23\n" + \ 

8 "25 27 29 31" + \ 

9 "\nEnter 0 for No and 1 for Yes: " 

10 answer = eval(input(questionl)) 

11 

12 if answer == 1: 

13 day += 1 

14 

15 # Prompt the user to answer the second question 

16 question2 = "Is your birthday in Set2?\n" + \ inquestionl? 

17 2 3 6 7\n" + \ 

18 "10 11 14 15\n" + \ 

19 "18 19 22 23\n" + \ 

20 "26 27 30 31" + \ 

21 "\nEnter 0 for No and 1 for Yes: " 

22 answer = eval(input(question2)) 

23 

24 if answer == 1: 

25 day += 2 

26 

27 # Prompt the user to answer the third question 

28 question3 = "Is your birthday in Set3?\n" + \ inquestionl? 

29 "456 7\n" + \ 

30 "12 13 14 15\n" + \ 

31 "20 21 22 23\n" + \ 

32 "28 29 30 31" + \ 

33 "\nEnter 0 for No and 1 for Yes: " 

34 answer = eval(input(question3)) 

35 

36 if answer == 

37 day += 4 


1 : 
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38 




39 

# Prompt the user to answer the 

fourth question 

in question4? 

40 

question4 = "Is your birthday ir 

1 Set4?\n" + \ 


41 

"8 9 10 ll\n" + \ 



42 

"12 13 14 15\n" + \ 



43 

"24 25 26 27\n" + \ 



44 

"28 29 30 31" + \ 



45 

"\nEnter 0 for No and 1 for 

Yes: " 


46 

answer = evai(input(question4)) 



47 




48 

if answer == 1: 



49 

day += 8 



50 




51 

# Prompt the user to answer the 

fifth question 

in questions? 

52 

question5 = "Is your birthday ir 

1 Set5?\n" + \ 


53 

"16 17 18 19\n"+ \ 



54 

"20 21 22 23\n" + \ 



55 

"24 25 26 27\n" + \ 



56 

"28 29 30 31" + \ 



57 

"\nEnter 0 for No and 1 for 

Yes: " 


58 

answer = evai(input(question5)) 



59 




60 

if answer == 1 : 



61 

day += 16 



62 




63 

print("\nYour birthday is "+ str(day) + 



Is your birthday in Setl? 

13 5 7 

9 11 13 15 

17 19 21 23 

25 27 29 31 

Enter 0 for No and 1 for Yes: 1 |^Enter 

Is your birthday in Set2? 

2 3 6 7 

10 11 14 15 

18 19 22 23 

26 27 30 31 

Enter 0 for No and 1 for Yes: 1 


Is your birthday in Set3? 

4 5 6 7 

12 13 14 15 
20 21 22 23 
28 29 30 31 

Enter 0 for No and 1 for Yes: 0 


Is your birthday in Set4? 

8 9 10 11 

12 13 14 15 
24 25 26 27 
28 29 30 31 

Enter 0 for No and 1 for Yes: 0 
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Is 

your 

31 rthday 

in Sets? 

16 

17 

18 

19 


20 

21 

22 

23 


24 

25 

26 

27 


28 

29 

30 

31 


Enter 

0 

for No and 1 for Yes: 1 1-*Enter| 

Your 

31 rthday i s 

19! 


line# 

day 

answer output 

1 

0 


10 


1 

13 

1 


22 


1 

25 

2 


34 


0 

46 


0 

58 


1 

61 

19 


63 


Your birthday is 19 




The last character \ at the end of lines 4-8 is the line continuation symbol, which tells the 
interpreter that the statement is continued on the next line (see Section 2.3). 

This game is easy to program. You may wonder how the game was created. The 
mathematics behind the game is actually quite simple. The numbers are not grouped mathematics behind the game 

together by accident. The way they are placed in the five sets is deliberate. The starting 
numbers in the five sets are 1, 2, 4, 8, and 16, which correspond to 1, 10, 100, 1000, and 
10000 in binary. A binary number for decimal integers between 1 and 31 has at most 
five digits, as shown in Figure 4.2a. Assume this number is b^b 4 bT,b 2 b\- So, 
bsbi[b 2 b 2 bi = fosOOOO + / 74 OOO + / 73 OO + b 2 ^ + i>i, as shown in Figure 4.2b. If a day’s binary 
number has a digit 1 in the number should appear in Set/:. For example, number 19 is 
binary 10011, so it appears in Sell, Set2, and Sets. It is binary 1 + 10 + 10000 = 10011 
or decimal 1 + 2 + 16 = 19. Number 31 is binary 11111, so it appears in Setl, Set2, Set3, 

Set4, and Sets. It is binary 1 + 10 + 100 + 1000 + 10000 = 11111 or decimal 1 + 2 
+ 4 + 8 + 16 = 31. 


fe; 0 0 0 0 


10000 

*40 0 0 


1000 

b^OO 

10000 

100 


10 

10 

+ bi 

+ 1 

+ 1 

65646362^1 

10011 

mil 


19 

31 


Decimal 

Binary 

1 

00001 

2 

00010 

3 

00011 

19 

10011 

31 

mil 


(a) (b) 


Figure 4-2 (a) A number between 1 and 31 can be represented using a S-digit binary num¬ 

ber. (b) A S-digit binary number can be obtained by adding binary numbers 1, 10, 100, 
1000, or 10000. 
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4.6 Two-Way if-else Statements 

A two-way i f-el se statement decides which statements to execute based on whether 
the condition is true or false. 


A one-way i f statement takes an action if the specified condition is True. If the condition is 
Fal se, nothing is done. But what if you want to take one or more alternative actions when the 
condition is Fal se? You can use a two-way i f-el se statement. The actions that a two-way 
i f-el se statement specifies differ based on whether the condition is True or Fal se. 

Here is the syntax for a two-way i f-el se statement: 


if boolean-expression: 

statement(s)-for-the-true-case 

el se: 

statement(s)-for-the-fal se-case 


The flowchart of the statement is shown in Figure 4.3. 


true boolean- false 



Figure 4-3 An i f-el se statement executes statements for the true case if the Boolean 
expression evaluates to True; otherwise, statements for the false case are executed. 

If the bool ean-expressi on evaluates to True, the statement(s) for the true case are exe¬ 
cuted; otherwise, the statement(s) for the false case are executed. For example, consider the 
following code: 

two-way i f-el se statement if radius >= 0: 

area = radius * radius * math.pi 

printC'The area for the circle of radius", radius, "is", area) 

else: 

pri ntC'Negative input") 

If radius >= 0 is true, area is computed and displayed; if it is false, the message 

Negative input is displayed. 

Here is another example of the i f-el se statement. This one determines whether a num¬ 
ber is even or odd, as follows: 

if number % 2 == 0: 

printfnumber , "is even.") 

else: 

printCnumber , 'is odd.") 

Suppose you want to develop a program for a first grader to practice subtraction. The pro¬ 
gram randomly generates two single-digit integers, numberl and numberZ, with numberl 
>= numberZ and asks the student a question such as "What is 9 - 2? After the student 
enters the answer, the program displays a message indicating whether it is correct. 
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The program may work as follows: 

Step 1: Generate two single-digit integers for numberl and numberZ. 

Step 2: If numberl < numberZ, swap numberl with numberZ. 

Step 3: Prompt the student to answer, “What is numberl - numberZ?” 

Step 4: Check the student’s answer and display whether the answer is correct. 

The complete program is shown in Listing 4.4. 

Listing 4>4 SubtractionQuiz.py 

1 import random import random module 

2 

3 #1. Generate two random single-digit integers 

4 numberl = random, randi nt(0, 9) random numbers 

5 numberZ = random.randi nt(0, 9) 

6 

7 # 2. If numberl < numberZ, swap numberl with numberZ 

8 if numberl < numberZ: swap if necessary 

9 numberl, numberZ = numberZ, numberl # Simultaneous assignment 
10 

11 #3. Prompt the student to answer "What is numberl - numberZ?" 

12 answer = eval(i nput("What is "+ str(numberl) + " - " + get answer 

13 strCnumberZ) + "? ")) 

14 

15 # 4. Check the answer and display the result 

16 if numberl - numberZ == answer: check the answer 

17 printC'You are correct!") 

18 else: 

19 printC'Your answer is wrong.\n'', numberl, 

20 numberZ, "is", numberl - numberZ, =') 


What is 6 - 6? 0 
You are correct! 



What is 9 - 2? 5 
Your answer is wrong. 
9 - 2 is 7. 



line# 

numberl 

number2 

answer 

output 

4 

2 




5 


9 



9 

9 

2 



12 



5 


19 




Your answer is wrong. 

9 - 2 is 7. 




If numberl < numberZ, the program uses simultaneous assignment to swap the two 
variables (lines 8-9). 

4-9 Write an i f statement that increases pay by 3% if score is greater than 90, other¬ 
wise it increases pay by 1%. 


^^eck 
W Point 
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My Program m i ngLab" 


r;^Key 
/ Point 


nested i f statement 


4* 10 What is the printout of the code in (a) and (b) if number is 30 and 35, respectively? 


if number % 2 == 0: 

print(number, "is even.") 

printfnumber, "is odd.") 


if number % 2 == 0 


print(number, 

'is even.") 

else 


print(number, 

'is odd.") 


(a) 


(b) 


4.7 Nested i f and Multi-Way i f-el i f-el se 
Statements 

One i f statement can be placed inside another i f statement to form a nested i f statement. 

The statement in an i f or i f-el se statement can be any legal Python statement, including 
another i f or i f-el se statement. The inner i f statement is said to be nested inside the outer 
i f statement. The inner i f statement can contain another i f statement; in fact, there is no 
limit to the depth of the nesting. For example, the following is a nested i f statement: 

if i > k: 

if j > k: 

printf'i and j are greater than k") 

else: 

printC'i is less than or equal to k") 

The i f j > k statement is nested inside the i f i > k statement. 

The nested i f statement can be used to implement multiple alternatives. The statement 
given in Figure 4.4a, for instance, assigns a letter value to the variable grade according to the 
score, with multiple alternatives. 


if score >= 90.0: 


if score >= 90.0: 

grade = 'A' 


grade = 'A' 

else: 


el if score >= 80.0: 

if score >= 80.0: 

Equivalent 

grade = 'B' 

grade = 'B' 


elif score >= 70.0: 

el se: 

J 

grade = 'C 

if score >= 70.0: 

f 

elif score >= 60.0: 

grade = 'C 

/ 

grade = 'O' 

el se: 

/ 

el se: 

if score >= 60.0: 

This is better 

grade = 'F' 

grade = 'D' 



el se: 



grade = 'F' 




(a) (b) 

Figure 4-4 A preferred format for multiple alternatives is shown in (b) using a multi-way 

7 f-el i f-else statement. 

The execution of how this i f statement proceeds is shown in Figure 4.5. The first condi¬ 
tion (score >= 90) is tested. If it is True, the grade becomes A. If it is Fal se, the second 
condition (score >= 80) is tested. If the second condition is True, the grade becomes B. If 
that condition is Fal se, the third condition and the rest of the conditions (if necessary) are 
tested until a condition is met or all of the conditions prove to be Fal se. If all of the condi¬ 
tions are Fal se, the grade becomes F. Note that a condition is tested only when all of the con¬ 
ditions that come before it are Fal se. 
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o 


^score >= 90 


false 



Figure 4-5 You can use a multi-way i f-el i f-el se statement to assign a grade. 


The 1 f statement in Figure 4.4a is equivalent to the i f statement in Figure 4.4h. In fact, Figure 
4.4b is the preferred coding style for multiple alternative i f statements. This style, called multi¬ 
way i f statements, avoids deep indentation and makes the program easier to read. The multi-way 
i f statements uses the syntax i f-el i f-el se; el i f (short for else if) is a Python keyword. 

Now let’s write a program to find out the Chinese zodiac sign for a given year. The Chinese 
zodiac sign is based on a 12-year cycle, and each year in this cycle is represented by an animal— 
monkey, rooster, dog, pig, rat, ox, tiger, rabbit, dragon, snake, horse, and sheep—as shown in 
Figure 4.6. 



0: monkey 
1: rooster 
2: dog 
3: pig 
4: rat 

year % 12 = < 

A 6: tiger 

7: rabbit 
8: dragon 
9: snake 
10: horse 
__ 11; sheep 


multi-way i f statement 


Figure 4-6 The Chinese zodiac is based on a 12-year cycle. 
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enter year 
12-year cycle 
determine zodiac sign 


The value of year % 12 determines the zodiac sign. 1900 is the year of the rat since 
1900 % 12 is 4. Listing 4.5 shows a program that prompts the user to specify a year, and then 
it displays the animal for that year. 

Listing 4>5 ChineseZodiac.py 

1 year = eval(i nput("Enter a year: ")) 

2 zodiacYear = year % 12 

3 if zodiacYear == 0: 

4 pri ntC'monkey") 

5 el if zodiacYear == 1: 

6 pri ntC'rooster") 

7 el if zodiacYear == 2: 

8 printC'dog") 

9 el if zodiacYear == 3: 

10 pri ntC'pig") 

11 el if zodiacYear == 4: 

12 printC’rat") 

13 el if zodiacYear == 5: 

14 printC'ox") 

15 el if zodiacYear == 6: 

16 pri ntC'tiger") 

17 el if zodiacYear == 7: 

18 printCrabbit") 

19 el if zodiacYear == 8: 

20 pri ntC'dragon") 

21 elif zodiacYear == 9: 

22 printC'snake") 

23 elif zodiacYear == 10: 

24 printC'horse") 

25 else: 

26 pri nt(’'sheep") 




Enter a 
rabbit 

year: 

1963 -"Enter 1 


Enter a 

ox 

year: 

1877 ^Enter| 


/Check 
1 Point 

MyProgrammingLab" 


4.11 


Suppose X = Sandy = 2; show the output, if any, of the following code. What is 
the output if X = 3 and y - 4? What is the output if x = 2 and y = 2? Draw a flow¬ 
chart for the code. 

if X > 2: 

if y > 2: 

z = X -I- y 
printC'z is", z) 
el se: 

printC'x is", x) 


4.12 Suppose X = 2 and y = 4. Show the output, if any, of the following code. What is 
the output if X = Sandy = 2? What is the output if x = Sandy = 3? (Hint: Indent 
the statement correctly first.) 
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if X > 2: 

if y > 2: 

z = X + y 
printC'z is", z) 

e1 se; 

printC'x is", x) 

4 -13 What is wrong in the following code? 

if score >= 60.0: 

grade = 'O' 
elif score >= 70.0: 

grade = 'C 
elif score >= 80.0: 

grade = B' 
elif score >= 90.0: 

grade = A' 
el se: 

grade = 'F' 


4.8 Common Errors in Selection Statements 

Most common errors in selection statements are caused by incorrect indentation. 
Consider the following code in (a) and (b). 


Key 
If- J Point 


radius = -20 


if radius >= 0: 

area = radius * 

radius * math.pi 

printC'The area is" 

, area) 


(a) Wrong 


radius = -20 


if radius >= 0: 

area = radius * 
printC'The area 

radius * math.pi 
is", area) 


(b) Correct 


In (a), the pri nt statement is not in the i f block. To place it in the i f block, you have to 
indent it, as shown in (b). 

Consider another example in the following code in (a) and (b). The code in (a) below has 
two i f clauses and one el se clause. Which i f clause is matched by the el se clause? The 
indentation indicates that the el se clause matches the first i f clause in (a) and the second i f 
clause in (b). 




Since (i > j) is false, the code in (a) displays B, but nothing is displayed from the state¬ 
ment in (b). 








106 Chapter 4 Selections 


assign Boolean variable 



Tip 

Often new programmers write the code that assigns a test condition to a Boolean 
variable, like the code in (a): 


if number % 2 == 0: 

Equivalent 

even = number 9 

'o 2 == 0 

even = True 




el se: 

This is shorter 



even = False 





(a) 


(b) 


The code can be simplified by assigning the test value directly to the variable, as shown in (b). 


4.14 Which of the following statements are equivalent? Which ones are correctly 
V Point indented? 

MyProgrammingLab" 


if i > 0: 


if i > 0: 


if i > 0: 


if i > 0: 

X = 0 


X = 0 


X = 0 


X = 0 

y = 1 


y = 1 


y = 1 


y = 1 

else: 


else: 


el se : 


else: 

y = 0 


y = 0 


y = 0 


o 

II 

> 

z = 0 


z = 0 


z = 0 


z = 0 


(a) (b) (c) (d) 


4.15 Rewrite the following statement using a Boolean expression: 

if count % 10 == 0: 

newLine = True 
el se: 

newLine = False 

4 . 16 Are the following statements correct? Which one is better? 


if age < 16: 


if age < 16: 

pri ntC'Cannot get a driver's license") 


pri ntC'Cannot get a driver's license") 

if age >= 16: 


else: 

printC'Can get a driver's license") 


printC'Can get a driver's license') 


(a) (b) 


4 . 17 What is the output of the following code if number is 14, 15, and 30? 


if number % 2 == 0: 

print(number, "is even") 
if number % 5 == 0: 

print(number, 'is multiple of 5") 


if number % 2 == 0 


print(number, 

"is even") 

el if number % 5 == 

0: 

printCnumber, 

"is multiple of 5") 


(a) 


(b) 
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4.9 Case Study: Computing Body Mass Index 

You can use nested i f statements to write a program that interprets body mass index. 

Body mass index (BMI) is a measure of health based on weight. It can be calculated by taking 
your weight in kilograms and dividing it by the square of your height in meters. The interpre¬ 
tation of BMI for people 16 years and older is as follows: 


Key 
^ Point 


BMI 

Below 18.5 
18.5-24.9 
25.0-29.9 
Above 30.0 


Interpretation 

Underweight 

Normal 

Overweight 

Obese 


Write a program that prompts the user to enter a weight in pounds and height in inches and 
then displays the BMI. Note that one pound is 0.45359237 kilograms and one inch is 
0.0254 meters. Listing 4.6 gives the program. 


Listing 4*6 ComputeBMI. py 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 


# Prompt the user to enter weight in pounds 
weight = eval(i nput("Enter weight in pounds; ")) 


# Prompt the user to enter height in inches 
height = eval(i nput("Enter height in inches: ")) 


KIL0GRAMS_PER_P0UND = 0.45359237 # Constant 

METERS_PER_INCH = 0.0254 # Constant 


# Compute BMI 

weightInKilograms = weight * KIL0CRAMS_PER_P0UND 

heightInMeters = height * METERS_PER_INCH 

bmi = weightInKilograms / (heightInMeters * heightInMeters) 


# Display result 

printC'BMI is", format(bmi, ".2f")) 
if bmi < 18.5: 

pri ntC'Underweight") 
el if bmi < 25: 

pri ntC'Normal ") 
el if bmi < 30: 

pri ntCOverweight”) 
else: 

printC'Obese") 


input weight 


input height 


compute bmi 


display output 


Enter weight in 

pounds: 

146 

-j Enter 1 

Enter height in 

inches: 

70 E 

Enter 


BMI is 20.95 





Normal 
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line# 

weight 

height 

weightInKilograms 

heightInMeters 

bmi 

output 

2 

146 






5 


70 





11 



66.22448602 




12 




1.778 



13 





20.9486 


16 






BMI is 20.95 

22 






Normal 



The two named constants, KIL0CRAMS_PER_P0UND and METERS_PER_INCH, are defined 
in lines 7-8. Named constants were introduced in Section 2.6. Using named constants here 
makes programs easy to read. Unfortunately, there is no special syntax for defining named 
constants in Python. Named constants are treated just like variables in Python. This book uses 
the format of writing constants in all uppercase letters to distinguish them from variables, and 
separates the words in constants with an underscore ( ). 

4.10 Case Study: Computing Taxes 

You can use nested i f statements to write a program for computing taxes. 

The United States federal personal income tax is calculated based on filing status and taxable 
income. There are four filing statuses: single filers, married filing jointly, married filing sepa¬ 
rately, and head of household. The tax rates vary every year. Table 4.2 shows the rates for 
2009. If you are, say, single with a taxable income of $10,000, the first $8,350 is taxed at 10% 
and the other $1,650 is taxed at 15%. So, your tax is $1,082.50. 


Table 4.2 

2009 U.S. Federal Personal Tax Rates 



Marginal 
Tax Rate 

Single 

Married Filing Jointly 

Married Filing Separately 

Head of Household 

10% 

$ 0 -$ 8,350 

$ 0 -$ 16,700 

$ 0 -$ 8,350 

$ 0 -$ 11,950 

15% 

$ 8 , 351 -$ 33,950 

$ 16 , 701 -$ 67,900 

$ 8,351 -$ 33,950 

$ 11,951 -$ 45,500 

25% 

$ 33,951 -$ 82,250 

$ 67,901 -$ 137,050 

$ 33,951 -$ 68,525 

$ 45,501 -$ 117,450 

28% 

$ 82,251 -$ 171,550 

$ 137,051 -$ 208,850 

$ 68 , 526 -$ 104,425 

$ 117,451 -$ 190,200 

33% 

$ 171,551 -$ 372,950 

$ 208,851 -$ 372,950 

$ 104 , 426 -$ 186,475 

$ 190,201 -$ 372,950 

35% 

$ 372 , 951 + 

$ 372 , 951 + 

$ 186 , 476 + 

$ 372 , 951 + 


named constants 


^/Key 
>P / Point 


You are to write a program to compute personal income tax. Your program should prompt 
the user to enter the filing status and taxable income and then compute the tax. Enter 0 for 
single filers, 1 for married filing jointly, 2 for married filing separately, and 3 for head of 
household. 

Your program computes the tax for the taxable income based on the filing status. The filing 
status can be determined using i f statements outlined as follows: 

if status == 0: 

# Compute tax for single filers 
el if status == 1: 

# Compute tax for married filing jointly 
el if status == 2: 
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# Compute tax for married filing separately 

el if status == 3: 

# Compute tax for head of household 

else: 

# Display wrong status 

For each filing status there are six tax rates. Each rate is applied to a certain amount of 
taxable income. For example, of a taxable income of $400,000 for single filers, $8,350 is 
taxed at 10%, (33,950 - 8,350) at 15%, (82,250 - 33,950) at 25%, (171,550 - 82,250) at 28%, 
(372,950 - 171,550) at 33%, and (400,000 - 372,950) at 35%. 

Listing 4.7 gives the solution to compute taxes for single filers. The complete solution is 
left as Programming Exercise 4.13 at the end of this chapter. 


Listing 4.7 ComputeTax. py 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 


import sys 

# Prompt the user to enter filing status 
status = eval(input( 

"(O-single filer, 1-married jointly,\n" + 
"2-married separately, 3-head of household)\n" + 
"Enter the filing status: ")) 

# Prompt the user to enter taxable income 

income = eval(i nput("Enter the taxable income: ")) 

# Compute tax 
tax = 0 

if status == 0: # Compute tax for single filers 

if income <= 8350: 

tax = income * 0.10 
el if income <= 33950: 

tax = 8350 * 0.10 + (income - 8350) * 0.15 
el i f income <= 82250: 
tax = 8350 * 0.10 + 

(income - 33950) 
el if income <= 171550: 

tax = 8350 * 0.10 + (33950 - 8350) * 

(82250 - 33950) * 0.25 + (income 
372950: 

0.10 + (33950 
(82250 - 33950) * 0.25 


(33950 - 8350) 
0.25 


0.15 + \ 


0.15 + \ 


elif income <= 
tax = 8350 


82250) * 0.28 


- 8350) * 0.15 + \ 

+ (171550 - 82250) * 0.28 + \ 


(income - 171550) * 0.33 


el se: 

tax = 8350 


0.10 + (33950 - 8350) 


0.15 + \ 
82250) 


0.28 + \ 


(82250 - 33950) * 0.25 + (171550 
(372950 - 171550) * 0.33 + (income - 372950) * 0.35; 
elif status == 1: # Compute tax for married file jointly 

printC'Left as exercise") 

el if status == 2: # Compute tax for married separately 

printC'Left as exercise') 

elif status == 3: # Compute tax for head of household 

printC'Left as exercise") 
else: 

pri ntC'Error : invalid status") 

sys.exit() 


import sys module 


input status 


input income 


compute tax 


exit program 


# Display the result 

printC'Tax is", format(tax, .2f")) 


display output 
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(O-single filer, l-married jointly, 
2-married separately, 3-hea d of household) 
Enter the filing status: 0 | 

Enter the taxable income: 400000 I 
Tax is 117683.50 


line# 

status 

income 

tax 

output 

4 

0 




10 


400000 



13 



0 


17 



117683.5 


45 




Tax is 117683.50 



The program receives the filing status and taxable income. The multiple alternative i f 
statements (lines 15, 34, 36, 38, and 40) check the filing status and compute the tax based on 
the filing status. 

sys. exi t C) sys. exi t () (line 42) is defined in the sys module. Invoking this function terminates the 

program. 

test all cases To test a program, you need to provide input that covers all cases. For this program, your 

input should cover all statuses (0, 1, 2, and 3). For each status, test the tax for each of the six 
brackets. So, there are a total of 24 cases. 


incremental development and 
testing 


For all programs, you should write a small amount of code and test it before moving on 
to add more code. This is called incremental development and testing. This approach 
makes debugging easier, because the errors are likely in the new code you just added. 


A 

W Pi 


heck 

Point 
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4*18 Are the following two statements equivalent? 


if income <= 10000: 


if income <= 10000: 

tax = income * 0.1 


tax = income * 0.1 

el if income <= 20000: 


el if income > 10000 and 

tax = 1000 + \ 


income <= 20000: 

(income - 10000) * 0.15 


tax = 1000 + \ 


(income - 10000) * 0.15 


4.19 What is wrong in the following code? 
income = 232323 

if income <= 10000: 

tax = income * 0.1 

el if income > 10000 and income <= 20000: 
tax = 1000 + (income - 10000) * 0.15 

print(tax) 


^^Key 
V (Point 


4.11 Logical Operators 

The logical operators not, and, and or can be used to create a composite condition. 

Sometimes, a combination of several conditions determines whether a statement is executed. 
You can use logical operators to combine these conditions to form a compound expression. 












4.11 Logical Operators III 


Logical operators, also known as Boolean operators, operate on Boolean values to create a 
new Boolean value. Table 4.3 lists the Boolean operators. Table 4.4 defines the not operator, 
which negates True to Fal se and Fal se to True. Table 4.5 defines the and operator. The 
and of two Boolean operands is true if and only if both operands are true. Table 4.6 defines 
the or operator. The or of two Boolean operands is true if at least one of the operands is true. 

Table 4-3 Boolean Operators 


Operator Description 


not 

logical negation 

and 

logical conjunction 

or 

logical disjunction 

Table 4.4 Truth Table for Operator not 



P 

not p 

Example (assume = 24, gender = 'F'j 

True 

Fal se 

not (age > 

18) is Fal se, because (age > 18) is True. 

Fal se 

True 

not (gender 

== 'M') is True, because (gender == 'M') is False. 

Table 4.5 

Truth Table for Operator and 

Pi 

P2 

Pi and P 2 

Example (assume age = 24, gender = 'F'j 

Fal se 

Fal se 

Fal se 

(age > 18) and (gender == ' F') is True, because 
(age > 18) and (gender == 'F') are both True. 

Fal se 

True 

Fal se 


True 

Fal se 

Fal se 

(age > 18) and (gender != ' F') is Fal se, because 
(gender != 'F') is False. 

True 

True 

True 


Table 4.6 

Truth Table for Operator or 

Pi 

P2 

Pi and P 2 

Example (assume age = 24, gender = 'F'j 

Fal se 

Fal se 

Fal se 

(age > 34) or (gender == ' F') is True, because 
(gender == 'F') is True. 

Fal se 

True 

True 


True 

Fal se 

True 

(age > 34) or (gender == ' M') is Fal se, because 
(age > 34) and (gender == ' M') are both Fal se. 

True 

True 

True 



The program in Listing 4.8 checks whether a number is divisible by 2 and 3, by 2 or 3, and 
by 2 or 3 but not both. 

Listing 4*8 TestBool eanOperators. py 

1 # Receive an input 

2 number = evai(i nput("Enter an integer: )) input 

3 

4 if number % 2 == 0 and number % 3 == 0: 

5 print(number, "is divisible by 2 and 3") 


and 
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or 


6 

7 if number % 2 == 0 or number % 3 == 0: 

8 print(number , 'is divisible by 2 or 3") 

9 

10 if (number % 2 == 0 or number % 3 == 0) and \ 

11 not (number % 2 == 0 and number % 3 == 0) : 

12 print(number , 'is divisible by 2 or 3, but not both") 





In line 4, number % 2 == 0 and number % 3 == 0 checks whether the number is 

divisible by 2 anr/ 4. number % 2 == 0 or number % 3 == 0 (line 7) checks whether 

the number is divisible by 2 or . The Boolean expression in lines 10-11 

(number % 2 == 0 and number % 3 == 0) and 

not (number % 2 == 0 and number % 3 == 0) 

checks whether the number is divisible by 2 or 3 but not both. 

Note 

De Morgan’s law De Morgan's law, named after Indian-born British mathematician and logician Augustus De 

Morgan (1806-1871), can be used to simplify Boolean expressions. The law states that: 

not (conditionl and condition!) is the same as 
not conditionl or not condition! 
not (conditionl or condition!) is the same as 
not conditionl and not condition! 

So, line 11 in the preceding example, 

not (number % 2 == 0 and number % 3 == 0) 

can be simplified by using an equivalent expression: 

(number % 2 != 0 or number % 3 != 0) 

As another example, 

not (number == 2 or number == 3) 
is better written as 

number != 2 and number != 3 

If one of the operands of an and operator is Fal se, the expression is Fal se; if one of 
the operands of an or operator is True, the expression is True. Python uses these proper¬ 
ties to improve the performance of these operators. When evaluating pi and p2, Python 
first evaluates pi and then, if pi is True, evaluates p2; if pi is Fal se, it does not evalu¬ 
ate p2. When evaluating pi or p2. Python first evaluates pi and then, if pi is False, 
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evaluates p2; if pi is True, it does not evaluate p2. Therefore, and is referred to as the 

conditional or short-circuit AND operator, and or is referred to as the conditional or conditional operator 

short-circuit OR operator. short-circuit evaluation 


4-20 Assuming that x is 1, show the result of the following Boolean expressions. 
True and (3 > 4) 
not (x > 0) and (x > 0) 

(x > 0) or (x < 0) 

(x != 0) or (x == 0) 

(x >= 0) or (x < 0) 

(x != 1) == not (x == 1) 


^Oieck 
W Point 
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4-21 Write a Boolean expression that evaluates to True if variable num is between 1 and 

100 . 


4-22 Write a Boolean expression that evaluates to True if variable num is between 1 and 
100 or the number is negative. 

4-23 Assuming X = Tandy = 5, show the result of the following Boolean expressions: 

X >= y >= 0 

X <= y >= 0 

X != y == 5 

(x != 0) or (x == 0) 

4.24 Are the following expressions equivalent? 

(a) (x >= 1) and (x < 10) 

(b) (1 <= X < 10) 

4.25 What is the value of the expression ch >= 'A' and ch <= 'Z' if ch is 'A', 'p', 
' E' , or ' 5' ? 

4.26 Suppose, when you run the following program, you enter input 2, 3, 6 from the 
console. What is the output? 

X, y, z = eval (i nputC'Enter three numbers: ")) 


print("(x < y and y < z) is", x < y and y < z) 
print("(x < y or y < z) is", x < y or y < z) 
printC'not (x < y) is", not (x < y)) 
printC'Cx < y < z) is", x < y < z) 
printC'notCx < y < z) is", not (x < y < z)) 

4.27 Write a Boolean expression that evaluates true if age is greater than 13 and less 
than 18. 

4.28 Write a Boolean expression that evaluates true if weight is greater than 50 or 
height is greater than 160. 

4.29 Write a Boolean expression that evaluates true if weight is greater than 50 and 
height is greater than 160. 

4.30 Write a Boolean expression that evaluates true if either weight is greater than 50 or 
height is greater than 160, but not both. 


4.12 Case Study: Determining Leap Years 

A year is a leap year if it is divisible by 4 but not by 100 or if it is divisible by 400. 

You can use the following Boolean expressions to determine whether a year is a leap year: 

# A leap year is divisible by 4 
isLeapYear = (year % 4 == 0) 

# A leap year is divisible by 4 but not by 100 
isLeapYear = isLeapYear and (year % 100 != 0) 


^/Key 
Y; Point 
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input 


leap year? 


display result 


# A leap year is divisible by 4 but not by 100 or divisible by 400 
isLeapYear = isLeapYear or (year % 400 == 0) 

or you can combine all these expressions into one, like this: 

isLeapYear = (year % 4 == 0 and year % 100 != 0) or (year % 400 == 0) 

Listing 4.9 is an example of a program that lets the user enter a year and then determines 
whether it is a leap year. 

Listing 4.9 LeapYear.py 

1 year = eval (i nput("Enter a year: ’')) 

2 

3 # Check if the year is a leap year 

4 isLeapYear = (year % 4 == 0 and year % 100 != 0) or \ 

5 (year % 400 == 0) 

6 

7 # Display the result 

8 print(year, 'is a leap year?", isLeapYear) 


Enter a year: 2008 1 

2008 is a leap year? True 


Enter a year: 1900 |^Enter| 
1900 is a leap year? False 



Enter a year: 2002 punter| 
2002 is a leap year? False 


r^y 

r ^ Point 


4.13 Case Study: Lottery 

The lottery program in this case study involves generating random numbers, 
comparing digits, and using Boolean operators. 


Suppose you want to develop a program to play a lottery. The program randomly generates a 
two-digit number, prompts the user to enter a two-digit number, and determines whether the 
user wins according to the following rules: 

1. If the user’s input matches the lottery in the exact order, the award is $10,000. 

2. If all the digits in the user’s input match all the digits in the lottery number, the award is 
$3,000. 

3. If one digit in the user’s input matches a digit in the lottery number, the award is $1,000. 
The complete program is shown in Listing 4.10. 


generate a lottery 


Listing 4*10 Lottery, py 


1 

2 

3 

4 

5 

6 
7 


import random 

# Generate a lottery number 
lottery = random.randi nt(0, 


99) 


enter a guess 


# Prompt the user to enter a guess 

guess = eval(input( 'Enter your lottery pick (two digits): ' )) 














# Get digits from lottery 
lotteryDigitl = lottery // 10 
lotteryDigitZ = lottery % 10 
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8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 


# Get digits from guess 
guessDigitl = guess // 10 
guessDigit2 = guess % 10 

printC'The lottery number is", lottery) 

# Check the guess 

if guess == lottery: 

printC'Exact match: you win $10,000") 
elif (guessDigit2 == lotteryDigitl and \ 
guessDigitl == lotteryDigit2): 
printC'Match all digits: you win $3,000") 
elif (guessDigitl == lotteryDigitl 

or guessDigitl == lotteryDigit2 
or guessDigit2 == lotteryDigitl 
or guessDigit2 == lotteryDigit2): 
printC'Match one digit: you win $1,000") 
el se : 

printC'Sorry , no match") 


exact match? 
match all digits? 


match one digit? 


Enter your lottery pick (two digits): 45 
The lottery number is 12 
Sorry, no match 



Enter your lottery pick (two digits): 23 |^Enter 

The lottery number is 34 

Match one digit: you win $1,000 






The program generates a lottery number using the random. randint(0, 99) function 
(line 4) and prompts the user to enter a guess (line 7). Note that guess % 10 obtains the last 
digit from guess and guess // 10 obtains the first digit from guess, since guess is a two- 
digit number (lines 14-15). 
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The program checks the guess against the lottery number in this order: 

1. First check whether the guess matches the lottery number exactly (line 20). 

2. If not, check whether the reversal of the guess matches the lottery number (lines 22-23). 

3. If not, check whether one digit is in the lottery number (lines 25-28). 

4. If not, nothing matches and display Sorry, no match (lines 30-31). 


4.14 Conditional Expressions 

A conditional expression evaluates an expression based on a condition. 

You might want to assign a value to a variable that is restricted by certain conditions. For 
example, the following statement assigns 1 to y if x is greater than 0, and -1 to y if x is less 
than or equal to 0 . 

if X > 0: 

y = 1 

e1 se: 

y = -1 

Alternatively, as in this next example, you can use a conditional expression to achieve the 
same result. 

y = 1 if X > 0 else -1 

conditional expression Conditional expressions are in a completely different style. The syntax is: 

expression! if boolean-expression else expression2 

The result of this conditional expression is expression! if boolean-expression is 
true; otherwise, the result is expressionZ. 

Suppose you want to assign the larger number of variables number! and numberZ to max. 
You can simply write a statement using the conditional expression: 

max = number! if number! > numberZ else numberZ 


Key 
Y Tpoint 


For another example, the following statement displays the message number is even if 
number is even, and otherwise displays number is odd. 


pri ntC'number is even" if number % 2 == 0 else "number is odd") 


ii^eck 
W Point 

MyProgrammingLab" 


4.31 Suppose that when you run the following program you enter the input 2, 3, 6 from 
the console. What is the output? 

X, y, z = eval (i nputC'Enter three numbers: ")) 
pri ntC'sorted" if x < y and y < z else "not sorted") 

4.32 Rewrite the following i f statements using a conditional expression: 


if ages >= 16: 


if count % 10 == 0: 

ticketPrice = 20 


print(count) 

el se: 


else: 

ticketPrice = 10 


print(count, end = ) 


4.33 Rewrite the following conditional expressions using i f/el se statements: 

(a) score = 3 * scale if x > !0 else 4 * scale 

(b) tax = income * 0.2 if income > !0000 else income * 0.!7 + !000 

(c) print(i if number % 3 == 0 else j) 
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4.15 Operator Precedence and Associativity 

Operator precedence and associativity determine the order in which operators are 
evaluated. 

Operator precedence and operator associativity determine the order in which Python evalu¬ 
ates operators. Suppose that you have this expression: 

3 + 4 * 4 > 5 * (4 + 3) - 1 

What is its value? What is the execution order of the operators? 

Arithmetically, the expression in the parentheses is evaluated first. (Parentheses can be 
nested, in which case the expression in the inner parentheses is executed first.) When evaluat¬ 
ing an expression without parentheses, the operators are applied according to the precedence 
rule and the associativity rule. 

The precedence rule defines precedence for operators. Table 4.7 contains the operators you 
have learned so far, with the operators listed in decreasing order of precedence from top to 
bottom. The logical operators have lower precedence than the relational operators and the 
relational operators have lower precedence than the arithmetic operators. Operators with the 
same precedence appear in the same group. 

Table 4.7 Operator Precedence Chart 

Precedence Operator 

+, - (Unary plus and minus) 

* * (Exponentiation) 

not 

*, /, //, % (Multiplication, division, integer division, and remainder) 

+, - (Binary addition and subtraction) 

<, <=, >, >= (Comparison) 

==, ! = (Equality) 

and 

or 

T =, +=, -=, *=, /=, //=, %= (Assignment operators) 

If operators with the same precedence are next to each other, their associativity determines 
the order of evaluation. All binary operators are left-associative. For example, since + and 
are of the same precedence and are left-associative, the expression 


is equivalent to 

a - b + c - d ((a - b) + c) - d 

Note 

Python has its own way to evaluate an expression internally. The result of a Python eval¬ 
uation is the same as that of its corresponding arithmetic evaluation. 

4.34 List the precedence order of the Boolean operators. Evaluate the following expressions: 

True or True and False 
True and True or False 

4.35 True or false? All the binary operators except are left-associative. 



Point 

operator precedence 
operator associativity 


precedence 


associativity 


behind the scenes 

/Check 

Point 

MyProgrammingLab" 







118 Chapter 4 Selections 

4.36 Evaluate the following expressions: 

2 * 2 - 3 > 2 and 4 - 2 > 5 
2*2-3>2or4-2>5 

4.37 Is (x > 0 and x < 10) the same as (Cx > 0) and (x < 10))? Is (x > 0 or 
X < 10) the same as (Cx > 0) or (x < 10))? Is (x > 0 or X < 10 and y 
< 0) the same as (x > 0 or (x < 10 and y < 0))? 


V'Vp, 
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Point 


4.16 Detecting the Location of an Object 

Detecting whether an object is inside another object is a common task in game 
programming. 


In game programming, often you need to determine whether an object is inside another 
object. This section gives an example of testing whether a point is inside a circle. The pro¬ 
gram prompts the user to enter the center of a circle, the radius, and a point. The program then 
displays the circle and the point along with a message indicating whether the point is inside or 
outside the circle, as shown in Figure 4.7a-b. 




Figure 4-7 The program displays a circle, a point, and a message indicating whether the point is inside or outside the 
circle. 


import turtle 
enter input 


draw a circle 


A point is in the circle if its distance to the center of the circle is less than or equal to the 
ra dius of the circle, as sho wn in Figure 4.7c. The formula for computing the distance is 
\/(x 2 — Xi)^ + (>>2 “ yif- Listing 4.11 gives the program. 

Listing 4>l I Poi ntInCi rcl e. py 

1 import turtle 

2 

3 xl, yl = eval(i nputC'Enter the center of a circle x, y: ")) 

4 radius = eval(i nputC'Enter the radius of the circle: ")) 

5 x2, y2 = eval(i nputC'Enter a point x, y: ")) 

6 

7 # Draw the circle 

8 turtle.penupO # Pull the pen up 

9 turtle.goto(xl, yl - radius) 

10 turtle.pendownO # Pull the pen down 

11 turtle.circle(radius) 

12 # Draw the point 
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13 

turtl e. penupO 

# 

Pull the 

pen up 


14 

turtle.goto(x2, y2) 





15 

turtl e. pendownO 

# 

Pull the 

pen down 


16 

turtle.begln_fi11O 

# 

Begin to 

fill color in a shape 


17 

turtle.col or ("red") 





18 

turtle.circl e(3) 





19 

turtle.end_fi11() 

# 

Fill the 

shape 

draw a point 

20 






21 

# Display the status 





22 

turtl e. penupO 

# 

Pull the 

pen up 


23 

turtle.goto(xl - 70, 

yl - radius 

- 20) 


24 

turtl e. pendownO 





25 






26 

d = ((x2 - xl) * (x2 

- 

xl) + (y2 

- yl) -» (y2 - yl)) 0.5 

compute distance 

27 

if d <= radius; 





28 

turtle.write( 'The | 

point is inside the circle’) 

in the circle 

29 

else: 





30 

turtle.write( 'The | 

point is outside the circle) 

not in the circle 

31 






32 

turtl e. hi deturtl eO 





33 






34 

turtl e. doneO 




pause 


The program obtains the circle’s center location and radius (lines 3-4) and the location of 
a point (line 5). It displays the circle (lines 8-11) and the point (lines 13-19). The program 
computes the distance between the center of the circle and the point (line 26) and determines 
whether the point is inside or outside the circle. 

The code in lines 16-19 draws a dot, which can be simplified using the dot method, pre¬ 
sented in Table 3.6, as follows: 

turtle. dot(6, "red") 

This method draws a red dot with diameter 6. 
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Chapter Summary 



I. A Boolean type variable can store a True or Fal se value. 


2. The relational operators (<, <=, ==, ! =, >, >=), which work with numbers and charac¬ 
ters, yield a Boolean value. 

3. The Boolean operators and, or, and not operate with Boolean values and variables. 

4- When evaluating pi and p2. Python first evaluates pi and then evaluates p2 if pi is 
True; if pi is False, it does not evaluate p2. When evaluating pi or p2, Python 
first evaluates pi and then evaluates p2 if pi is Fal se; if pi is True, it does not eval¬ 
uate p2. Therefore, and is referred to as the conditional or short-circuit AND 
operator, and or is referred to as the conditional or short-circuit OR operator. 
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5. Selection statements are used for programming with alternative courses. There are 
several types of selection statements: i f statements, i f-el se statements, nested 
1 f-el i f-el se statements, and conditional expressions. 

6. The various i f statements all make control decisions based on a Boolean expression. 
Based on the True or Fal se evaluation of the expression, these statements take one 
of two possible courses. 

7. The operators in arithmetic expressions are evaluated in the order determined by the 
rules of parentheses, operator precedence, and operator associativity. 

8 . Parentheses can be used to force the order of evaluation to occur in any sequence. 

9. Operators with higher precedence are evaluated earlier. For operators of the same 
precedence, their associativity determines the order of evaluation. 

Test Questions 

Do test questions for this chapter online at www.cs.armstrong.edu/liang/py/test.html. 

MyProgrammingLab" PROGRAMMING EXERCISES 


think before coding 


leant from mistakes 



Pedagogical Note 

For each exercise, you should carefully analyze the problem requirements and design 
strategies for solving the problem before coding. 


Debugging Tip 

Before you ask for help, read and explain the program to yourself, and trace it using 
several representative inputs by hand or using an IDE debugger. You learn how to pro¬ 
gram by debugging your own mistakes. 


Section 4-2 

*4" I {Algebra: solve quadratic equations) The two roots of a quadratic equation, for 
example, ax^ + bx + c = 0 , can be obtained using the following formula: 


— b + s/b'^ — 4ac 


r\ 


2a 


and 


— b — s/b^ — Aac 


ri 


2a 


b^ — A-ac is called the discriminant of the quadratic equation. If it is positive, the 
equation has two real roots. If it is zero, the equation has one root. If it is negative, 
the equation has no real roots. 

Write a program that prompts the user to enter values for a, b, and c and displays 
the result based on the discriminant. If the discriminant is positive, display two 
roots. If the discriminant is 0, display one root. Otherwise, display The equa¬ 
tion has no real roots. Here are some sample runs. 
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Enter a, b, c: 1.0, 3, 1 r^^nter| 

The roots are -0.381966 and -2.61803 


Enter a, 

b, C: 1, 2.0, 1 1'^ Enter] 

The root 

i s -1 





*4-2 (Game: add three numbers) The program in Listing 4.1 generates two integers and 
prompts the user to enter the sum of these two integers. Revise the program to gen¬ 
erate three single-digit integers and prompt the user to enter the sum of these three 
integers. 

Sections 4-3-4-8 

*4-3 (Algebra: solve 2X2 linear equations) You can use Cramer’s rule to solve the 
following 2X2 system of linear equation; 

ax + by = e ed — bf af — ec 

X = - y = - 

cx + dy = f ad — be ad — be 

Write a program that prompts the user to enter a, b, c, d, e, and f and display the 
result. If - he is 0, report that The equation has no solution. 


Enter a, b, c: 1, 2, 3 |^Enter| 
The equation has no real roots 


Enter a, b, c, d, e, f: 
X is -2.0 and y is 3.0 

9.0, 

4.0, 

3.0, 

-5.0, -6.0, -21.0 p Enter] 


Enter a, b, c, d, e, f: 1.0, 
The equation has no solution 

2.0, 

2.0, 

4.0, 4.0, 5.0 '^Enter| 



**4-4 (Game: learn addition) Write a program that generates two integers under 100 and 
prompts the user to enter the sum of these two integers. The program then reports 
true if the answer is correct, false otherwise. The program is similar to Listing 4.1. 

*4*5 (Find future dates) Write a program that prompts the user to enter an integer for 

today’s day of the week (Sunday is 0, Monday is 1, ..., and Saturday is 6). Also 
prompt the user to enter the number of days after today for a future day and dis¬ 
play the future day of the week. Here is a sample run: 


Enter today's day: 1 Enter| 

Enter the number of days elapsed since today: 3 |^Enter 
Today is Monday and the future day is Thursday 
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Enter today's day: 0 i^"ter| _ 

Enter the number of days elapsed since today: 31 ^nter 
Today is Sunday and the future day is Wednesday 


*4-6 (Health application: BMI) Revise Listing 4.6, ComputeBMI.py, to let users enter 
their weight in pounds and their height in feet and inches. For example, if a person 
is 5 feet and 10 inches, you will enter 5 for feet and 10 for inches. Here is a sam¬ 
ple run: 



4-7 (Financial application: monetary units) Modify Listing 3.4, ComputeChange.py, 
to display the nonzero denominations only, using singular words for single units 
such as 1 dollar and 1 penny, and plural words for more than one unit such as 2 
dollars and 3 pennies. 

*4-8 (Sort three integers) Write a program that prompts the user to enter three integers 
and displays them in increasing order. 

*4-9 (Financial: compare costs) Suppose you shop for rice and find it in two different¬ 
sized packages. You would like to write a program to compare the costs of the 
packages. The program prompts the user to enter the weight and price of each 
package and then displays the one with the better price. Here is a sample run: 



Enter weight and price for package 1: 50, 24.59 
Enter weight and price for package 2: 25, 11.99 hI 
Package 1 has the better price. 


4*10 (Game: multiplication quiz) Listing 4.4, SubtractionQuiz.py, randomly generates 
a subtraction question. Revise the program to randomly generate a multiplication 
question with two integers less than 100. 

Sections 4-9-4-I6 

*4*1 I (Find the number of days in a month) Write a program that prompts the user to 
enter the month and year and displays the number of days in the month. For exam¬ 
ple, if the user entered month 2 and year 2000, the program should display that 
February 2000 has 29 days. If the user entered month 3 and year 2005, the pro¬ 
gram should display that March 2005 has 31 days. 

4*12 (Check a number) Write a program that prompts the user to enter an integer and 
checks whether the number is divisible by both 5 and 6, divisible by 5 or 6, or just 
one of them (but not both). Here is a sample run: 



Enter an integer: 10 Enter| 

Is 10 divisible by 5 and 6? False 

Is 10 divisible by 5 or 6? True 

Is 10 divisible by 5 or 6, but not both? True 
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*4-13 {Financial application: compute taxes) Listing 4.7, ComputeTax.py, gives the 
source code to compute taxes for single filers. Complete Listing 4.7 to give the 
complete source code for the other filing statuses. 

4-14 {Game: heads or tails) Write a program that lets the user guess whether a flipped 
coin displays the head or the tail. The program randomly generates an integer 0 or 
1, which represents head or tail. The program prompts the user to enter a guess 
and reports whether the guess is correct or incorrect. 

**4-15 {Game: lottery) Revise Listing 4.10, Lottery.py, to generate a three-digit lottery 
number. The program prompts the user to enter a three-digit number and deter¬ 
mines whether the user wins according to the following rules: 

1. If the user input matches the lottery number in the exact order, the award is 

$ 10 , 000 . 

2. If all the digits in the user input match all the digits in the lottery number, the 
award is $3,000. 

3. If one digit in the user input matches a digit in the lottery number, the award is 

$ 1 , 000 . 

4.16 {Random character) Write a program that displays a random uppercase letter. 

*4-1 7 {Game: scissor, rock, paper) Write a program that plays the popular scissor-rock- 
paper game. (A scissor can cut a paper, a rock can knock a scissor, and a paper can 
wrap a rock.) The program randomly generates a number 0, 1, or 2 representing 
scissor, rock, and paper. The program prompts the user to enter a number 0, 1, or 
2 and displays a message indicating whether the user or the computer wins, loses, 
or draws. Here are sample runs: 



VideoNote 

Coffee price 


scissor (0), rock (1), paper (2): 1 |^Enter| 

The computer is scissor. You are rock. You won. 


scissor (0), rock (1), paper (2): 2 Enter j 

The computer is paper. You are paper too. It is a draw. 




*4.18 {Financials: currency exchange) Write a program that prompts the user to enter 
the currency exchange rate between U.S. dollars and Chinese Renminbi (RMB). 
Prompt the user to enter 0 to convert from U.S. dollars to Chinese RMB and 1 for 
vice versa. Prompt the user to enter the amount in U.S. dollars or Chinese RMB to 
convert it to Chinese RMB or U.S. dollars, respectively. Here are some sample 
runs: 


Enter the exchange rate from dollars to RMB: 6.81 
Enter 0 to convert dollars to RMB and 1 vice versa: 
Enter the dollar amount: 100 ^Enter| 

$100.0 is 681.0 yuan 


1 -I Enter 


0 

^ Enter j 



Enter the exchange rate from dollars to RMB: 6.81 |^Enter |_ 

Enter 0 to convert dollars t o RMB and 1 vice versa: 1 Enter 

Enter the RMB amount: 10000 [ ^ Enter | 

10000.0 yuan is $1468.43 
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Enter the exchange rate from dollars to RMB: 6.81 g^terI 
Enter 0 to convert dollars to RMB and 1 vice versa: 5 r 
Incorrect Input 


**4" 19 (Compute the perimeter of a triangle) Write a program that reads three edges for a 
triangle and computes the perimeter if the input is valid. Otherwise, display that 
the input is invalid. The input is valid if the sum of every pair of two edges is 
greater than the remaining edge. Here is a sample run: 




Enter three edges: 1, 
The perimeter is 3 

1. 





Enter three edges: 1, 
The input is invalid 

3, 



*4-20 (Science: wind-chill temperature) Exercise 2.9 gives a formula to compute the 
wind-chill temperature. The formula is valid for temperatures in the range 
between —58°F and 41°F and for wind speed greater than or equal to 2. Write a 
program that prompts the user to enter a temperature and a wind speed. The pro¬ 
gram displays the wind-chill temperature if the input is valid; otherwise, it dis¬ 
plays a message indicating whether the temperature and/or wind speed is invalid. 

Comprehensive 

**4*21 (Science: day of the week) Zeller’s congruence is an algorithm developed by 
Christian Zeller to calculate the day of the week. The formula is 


h = \ q + 


26(m -f 1) 
K) 


k -\- 




+ 5; % 7 


where 


h is the day of the week (0: Saturday, 1: Sunday, 2: Monday, 3: Tuesday, 
4: Wednesday, 5: Thursday, 6: Friday), 
q is the day of the month. 

m is the month (3: March, 4: April,..., 12: December). January and February are 
counted as months 13 and 14 of the previous year. 
year 


j is the century (i.e., 


100 


)■ 


k is the year of the century (i.e., year % 100). 


Write a program that prompts the user to enter a year, month, and day of the 
month, and then it displays the name of the day of the week. Here are some sam¬ 
ple runs: 



Enter year: (e.g., 
Enter month: 1-12: 


20 08): 2013 E] 

Enter the day of the month: 1-31: 
Day of the week is Friday 
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Enter year: (e.g., 20 08) : 2012 Enter| 

Enter month: 1-12: 5 Enter| _ 

Enter the day of the month: 1-31: 12 Entet 
Day of the week is Saturday 



(Hint: [n\ = nll\ for a positive n. January and February are counted as 13 and 14 
in the formula, so you need to convert the user input 1 to 13 and 2 to 14 for the 
month and change the year to the previous year.) 

**4-22 (Geometry: point in a circle?) Write a program that prompts the user to enter a 
point (x, y) and checks whether the point is within the circle centered at (0, 0) with 
radius 10. For example, (4, 5) is inside the circle and (9, 9) is outside the circle, as 
shown in Figure 4.8a. 


y-axis , 

j9,9) 

(4,5^ 

y-axis , 


(6,4) 

• 


, (2. 2) 


(0,0) / x-axis 


(0.0) 

x-axis 


(a) (b) 


Figure 4-8 (a) Points inside and outside of the circle; (b) points inside and outside of the 

rectangle. 


(Hint: A point is in the circle if its distance to (0, 0) is less than or equa l to 10. The 
formula for computing the distance is 'S/(x 2 ~ x^)^ + (y 2 — yi)^. Test your 
program to cover all cases.) Two sample runs are shown next. 





**4-23 (Geometry: point in a rectangle?) Write a program that prompts the user to enter 
a point (x, y) and checks whether the point is within the rectangle centered at 
(0, 0) with width 10 and height 5. For example, (2, 2) is inside the rectangle and 
(6, 4) is outside the rectangle, as shown in Figure 4.8b. (Hint: A point is in the 
rectangle if its horizontal distance to ( 0 , 0 ) is less than or equal to 10 / 2 and 
its vertical distance to (0, 0) is less than or equal to 5.0 / 2. Test your program 
to cover all cases.) Here are two sample runs: 


Enter a point with two coordinates: 2, 2 [center 
Point (2.0, 2.0) is in the rectangle 
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Enter a point with two coordinates: 6, 4 !^Enter] 
Point (6.0, 4.0) is not in the rectangle 


**4-24 {Game: pick a card ) Write a program that simulates picking a card from a deck of 
52 cards. Your program should display the rank (Ace, 2, 3, 4, 5, 6, 7, 8, 9, 10, 

Jack, Queen, King) and suit (dubs. Diamonds, Hearts, Spades) of the card. 
Here is a sample run of the program: 



The card you picked is the lack of Hearts 


*4-25 {Geometry: intersecting point) Two points on line 1 are given as (xl, yl) and (x2, 
y2) and on line 2 as (x3, y3) and (x4, y4), as shown in Figure 4.9a-b. 


Figure 4-9 


{x2, y2) 


(x2, y2) 




(x2, y2) (x3, y3) 



(a) (b) (c) 

Two lines intersect in (a-h) and two lines are parallel in (c). 


The intersecting point of the two lines can be found by solving the following lin¬ 
ear equation; 

(Ti - y2)x - {x I - X2)y = {yI - y2)xi - {xi - X2)yi 

Cvs - ydx - {X3 - x^)y = {ys - y4)x3 - {x^ - X4)y3 

This linear equation can be solved using Cramer’s rule (see Exercise 4.3). If the 
equation has no solutions, the two lines are parallel (Figure 4.9c). Write a program 
that prompts the user to enter four points and displays the intersecting point. Here 
are sample runs: 





4*26 {Palindrome number) Write a program that prompts the user to enter a three-digit 
integer and determines whether it is a palindrome number. A number is a palindrome 
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if it reads the same from right to left and from left to right. Here is a sample run of 
this program: 


Enter a three-digit integer: 
121 is a palindrome 

12 1 1 ^ Enter | 



Enter a three-digit integer: 
123 is not a palindrome 

12 3 1 Enter | 




**4-27 (Geometry: points in triangle?) Suppose a right triangle is placed in a plane as 
shown below. The right-angle point is at (0, 0), and the other two points are at 
(200, 0), and (0, 100). Write a program that prompts the user to enter a point with 
X- and y-coordinates and determines whether the point is inside the triangle. Here 
are some sample runs: 



Enter a point's x- and y-coordinates: 100.5, 25.5 | 

The point is in the triangle 



Enter a point's x- and y-coordinates: 100.5, 50.5 | 

The point is not in the triangle 



**4-28 (Geometry: two rectangles) Write a program that prompts the user to enter the 
center x-, y-coordinates, width, and height of two rectangles and determines 
whether the second rectangle is inside the first or overlaps with the first, as shown 
in Figure 4.10. Test your program to cover all cases. 


wl 



wl 



iv2 

• (JcTyi) 



hi 

• 


(x2, yl) 

1 


(b) 


Figure 4-10 (a) A rectangle is inside another one. (b) A rectangle overlaps another one. 
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Here are some sample runs: 


Enter 

rl's center 

x^^y-coordi nates, 

width, 

and 

height: 

2.5, 

4, 2.5, 43 

I^Ente^ 




Enter 

r2's center 

X-, y-coordinates, 

width, 

and 

height: 

1.5, 

5, 0.5, 3 

—1 Enter 




r2 is 

inside rl 







Enter rl's center x-, 
1, 2, 3, 5.5 1-Enter 1 

y-coordinates, 

width, 

and 

height: 

Enter r2's center x-, 
3 , 4 , 4.5, 5 1 - Enter | 
r2 overlaps rl 

y-coordinates, 

width, 

and 

height: 




Enter rl's ce nter x-, y-coordinates, width, and height: 

1, 2 , 3 , 3 C enter 

Enter r2's cent er x- , y-coordinates, width, and height: 

40, 45, 3, 2 F^l 
r2 does not overlap rl 


** 4-29 (Geometry: two circles) Write a program that prompts the user to enter the center 
coordinates and radii of two circles and determines whether the second circle is 
inside the first or overlaps with the first, as shown in Figure 4.11. (Hint: circle2 is 
inside circle 1 if the distance between the two centers <= | rl - r2 | and circle2 
overlaps circle 1 if the distance between the two centers <= rl + r2. Test your 
program to cover all cases.) 




Figure 4- II (a) A circle is inside another circle, (b) A circle overlaps another circle. 


Here are some sample runs: 


Enter circlel's center x-, y-coordinates, and radius: 
0.5, 5.1, 13 I center I 

Enter circ1e2' s cen ter x-, y-coordinates, and radius: 

1, 1.7, 4.5 p Enter I 
circle2 is inside circlel 



Enter circlel's cente r x-, y-coordinates, and radius: 
4.4, 5.7, 5.5 1^ Enter | 

Enter circ1e2' s cen ter x-, y-coordinates, and radius: 

6.7, 3.5, 3 l^ter I 
circle2 overlaps circlel 
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Enter circlel's center x-, y-coordinates, 
4.4, 5.5, 1 1-Enter] 

and 

radius: 

Enter circle2's center x-, y-coordinates, 
5.5, 7.2, 1 |:^ter] 
circle2 does not overlap circlel 

and 

radius: 



*4»30 {Current time) Revise Programming Exercise 2.18 to display the hour using a 12- 
hour clock. Here is a sample run: 


Enter the time zone offset to CMT: -5 hunter 
The current time is 4:50:34 AM 



*4-3 I {Geometry: point position) Given a directed line from point p0(x0, yO) to pl(xl, 

yl), you can use the following condition to decide whether a point p2(x2, y2) is 
on the left side of the line, on the right side of the line, or on the same line (see 
Figure 4.12): 


(xl - x0)*(y2 - yO) - (x2 - x0)*(yl - yO) 



p2 is on the left side of the line 

p2 is on the same line 

p2 is on the right side of the line 



Figure 4-12 (a) p2 is on the left side of the line, (b) p2 is on the right side of the line, (c) p2 

is on the same line. 


Write a program that prompts the user to enter the x- and y-coordinates for the 
three points pO, pi, and p2 and displays whether p2 is on the left side of the line 
from pO to pi, on the right side, or on the same line. Here are some sample runs: 




























130 Chapter 4 Selections 


*4-32 (Geometry: point on line segment) Exercise 4.31 shows how to test whether a point 
is on an unbounded line. Revise Exercise 4.31 to test whether a point is on a line 
segment. Write a program that prompts the user to enter the x- and y-coordinates 
for the three points pO, pi, and p2 and displays whether p2 is on the line segment 
from pO to pi. Here are some sample runs: 



Enter coordinates for the three points pO, pi, and p2: 


1, 1, 2.5, 2.5, 1.5, 1.5 CBnterl 
(1.5, 1.5) is on the line segment from (1.0, 1.0) to (2.5, 


2.5) 



Enter coordinates for t he th ree points pO, pi, and p2: 

1, 1, 2, 2, 3.5, 3.5 

(3.5, 3.5) is not on the line segment from (1.0, 1.0) to 

( 2 . 0 , 2 . 0 ) 


*4-33 (Decimal to hex) Write a program that prompts the user to enter an integer 
between 0 and 15 and displays its corresponding hex number. Here are some sam¬ 
ple runs: 



Enter a decimal value (0 to 15): 11 Center| 

The hex value is B 



Ifll 

Enter a decimal value (0 to 15): 5 |;^Enter| 


The hex value is 5 




Enter a decimal value (0 to 15): 31 Center| 

Invalid input 


*4-34 (Hex to decimal) Write a program that prompts the user to enter a hex character 
and displays its corresponding decimal integer. Here are some sample runs: 



Enter a hex character: A | 

The decimal value is 10 


Enter a hex character: a |'center| 
The decimal value is 10 


Enter a hex character: 5 ||-"enter 
The decimal value is 5 
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Enter a hex character: C enter 
Invalid input 



*4-35 {Turtle: point position) Write a program that prompts the user to enter the x- and 
y-coordinates for the three points pO, pi, and p2, and displays a message to 
indicate whether p2 is on the left side, the right side, or on the line from pO to pi, 
as shown in Figure 4.13. See Exercise 4.31 for determining the point position. 




Figure 4-13 The program displays the point position graphically. 


**4-36 (Turtle: point in a circle?) Modify Listing 4.11 to let the program randomly gen¬ 
erate a point within the square whose center is the same as the circle center and 
whose side is the diameter of the circle. Draw the circle and the point. Display a 
message to indicate whether the point is inside the circle. 

**4.37 (Turtle: point in a rectangle?) Write a program that prompts the user to enter a 
point Cx, y) and checks whether the point is within the rectangle centered at (0, 
0) with width 100 and height 50. Display the point, the rectangle, and a message 
indicating whether the point is inside the rectangle in the window, as shown in 
Figure 4.14. 


Python Turtle Graphics 


r=;rn;:-x 


J 


The point is inside the rectangle ^ 

I >1 

(a) 



(b) 


Figure 4-14 The program displays the rectangle, a point, and a message whether a point is 
in or outside of the rectangle. 


*4-38 (Geometry: two rectangles) Write a program that prompts the user to enter the 
center x-, y-coordinates, width, and height of two rectangles and determines 
whether the second rectangle is inside the first or overlaps with the first, as shown 
in Figure 4.15. 
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Figure 4-15 The program checks whether a rectangle is inside another one, overlaps another one, or does not overlap. 


*4-39 (Turtle: two circles) Write a program that prompts the user to enter the center 
coordinates and radii of two circles and determines whether the second circle is 
inside the first or overlaps with the first, as shown in Figure 4.16. 



Figure 4-16 The program displays two circles and a status message. 
















































































CHAPTER 


5 

Loops 

objectives 

■ To write programs for executing statements repeatedly by using 
a while loop (§5.2). 

■ To develop loops following the loop design strategy (§§5.2.1-5.2.3). 

■ To control a loop with the user’s confirmation (§5.2.4). 

■ To control a loop with a sentinel value (§5.2.5). 

■ To obtain a large amount of input from a file by using input redirection 
instead of typing from the keyboard and to save output to a file by using 
output redirection (§5.2.6). 

■ To use for loops to implement counter-controlled loops (§5.3). 

■ To write nested loops (§5.4). 

■ To learn the techniques for minimizing numerical errors (§5.5). 

■ To learn loops from a variety of examples (GCD, FutureTui tion, 

MonteCarloSimulation, PrimeNumber) (§§5.6, 5.8). 

■ To implement program control with break and conti nue (§5.7). 

■ To use a loop to simulate a random walk (§5.9). 
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problem 
why loop? 
loop 


5.1 Introduction 


iT' J Point 


A loop can be used to tell a program to execute statements repeatedly. 

Suppose that you need to display a string (e.g., Programmi ng i s fun I ) 100 times. It would 
be tedious to type the statement 100 times: 


100 times 


pri ntC'Programming is fun!") 
pri ntCProgramming is fun!") 


print ("Programming is fun!") 


So, how do you solve this problem? 

Python provides a powerful construct called a loop, which controls how many times in suc¬ 
cession an operation (or a sequence of operations) is performed. By using a loop statement, 
you don’t have to code the print statement a hundred times; you simply tell the computer to 
display a string that number of times. The loop statement can be written as follows: 


count = 0 

while count < 100: 

pri ntC'Programming is fun!") 
count = count + 1 


The variable count is initially 0. The loop checks whether count < 100 is true. If so, it 
loop body executes the loop body —the part of the loop that contains the statements to be repeated—to 

display the message Programming is fun! and increments count by 1. It repeatedly exe¬ 
cutes the loop body until count < 100 becomes false (i.e., when count reaches 100). At 
this point the loop terminates and the next statement after the loop statement is executed. 

A loop is a construct that controls the repeated execution of a block of statements. The con¬ 
cept of looping is fundamental to programming. Python provides two types of loop state- 
condition-controlled loop ments: while loops and for loops. The while loop is a condition-controlled loop', it is 

count-controlled loop controlled by a true/false condition. The for loop is a count-controlled loop that repeats a 

specified number of times. 


while loop 




5.2 The while Loop 

A whil e loop executes statements repeatedly as long as a condition remains true. 
The syntax for the whi 1 e loop is: 


while 1oop-continuation-condition: 
# Loop body 
Statement(s) 


iteration 

1oop-continuation- 
condi ti on 



VideoNote 

while loop 


Figure 5.1a shows the while-loop flowchart. A single execution of a loop body is called an 
iteration (or repetition) of the loop. Each loop contains a loop-continuation-condition, a 
Boolean expression that controls the body’s execution. It is evaluated each time to determine if the 
loop body should be executed. If its evaluation is True, the loop body is executed; otherwise, the 
entire loop terminates and the program control turns to the statement that follows the while loop. 

The loop that displays Programming is fun! 100 times is an example of a while loop. 
Its flowchart is shown in Figure 5.1b. The loop-continuation-condition is count < 
100 and the loop body contains two statements: 

. loop-continuation-condition 

count = 0 

while count < 100: 


pri ntC'Programming is fun!") 
count = count -t 1 


loop body 
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Figure 5.1 The while loop repeatedly executes the statements in the loop body as long as 

the loop-continuation-condition evaluates to True. 


Here is another example illustrating how a loop works: 

sum = 0 
i = 1 

while i < 10: 

sum = sum + i 
i = i + 1 

printC'sum is", sum) # sum is 45 


If i <10 is true, the program adds i to sum. The variable i is initially set to 1, then incre¬ 
mented to 2, 3, and so on, up to 10. When is 10, i < 10 is false, and the loop exits. So sum 
is 1 + 2 + 3+ ... + 9 = 45. 

Suppose the loop is mistakenly written as follows: 

sum = 0 
i = 1 

while i <10: 

sum = sum + i 
i = i + 1 



Note that the entire loop body must be indented inside the loop. Here the statement i = i + 1 
is not in the loop body. This loop is infinite, because i is always 1 and i < 10 will always be tme. 



Note 

Make sure that the loop-continuation-condition eventually becomes false so 
that the loop will terminate. A common programming error involves infinite loops (i.e., 
the loop runs forever). If your program takes an unusual long time to run and does not 
stop, it may have an infinite loop. If you run the program from the command window, 
press CTRL+C to stop it. 



Caution 

Programmers often mistakenly execute a loop one time more or less than intended. This 
kind of mistake is commonly known as the off-by-one error. For example, the following 
loop displays Programming is fun 101 times rather than 100 times. The error lies 
in the condition, which should be count < 100 rather than count <= 100. 


count = 0 

while count <= 100 : 

print( 'Programming is fun!") 
count = count + 1 


infinite loop 


off-by-one eiTor 
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random number 1 
random number! 


swap numbers 


enter answer 


check answer 
enter answer again 


Recall that Listing 4.4, SubtractionQuiz.py, gives a program that prompts the user to enter 
an answer for a question on subtraction. Using a loop, you can now rewrite the program to let 
the user enter a new answer until it is correct, as shown in Listing 5.1. 

Listing 5.1 RepeatSubtractionQuiz.py 

1 import random 

2 

3 #1. Generate two random single-digit integers 

4 numberl = random.randi nt(0, 9) 

5 numberZ = random.randi nt(0, 9) 

6 

7 # 2. If numberl < number2, swap numberl with number2 

8 if numberl < number2: 

9 numberl, number2 = number2, numberl 
10 

11 #3. Prompt the student to answer "What is numberl - number2?" 

12 answer = eval(i nput("What is " + str(numberl) + " - " 

13 + str(number2) + "? ')) 

14 

15 # 4. Repeatedly ask the question until the answer is correct 

16 while numberl - number2 != answer: 

17 answer = eval(i nput("Wrong answer. Try again. What is " 

18 + str(numberl) + " - " + str(number2) + "? ")) 

19 

20 printC'You got it!") 


What is 4 - 3? 4 

-1 Enter | 






Wrong answer. Try 

again. 

What 

is 4 - 

3? 

5 

[p^nte^ 

Wrong answer. Try 

again. 

What 

is 4 - 

3? 

1 


You got it! 









The loop in lines 16-18 repeatedly prompts the user to enter an answer when numberl - 

numberZ != answer is true. Once numberl - numberZ != answer is false, the loop exits. 

5.2.1 Case Study: Guessing Numbers 

The problem is to guess what number a computer has in mind. You will write a program that 
randomly generates an integer between 0 and 100, inclusive. The program prompts the user to 
enter numbers continuously until it matches the randomly generated number. For each user 
input, the program reports whether it is too low or too high, so the user can choose the next 
input intelligently. Here is a sample run: 



Guess a magic number betwe en 0 and 100 
Enter your guess: 50 [hentTr] 

Your guess is too high_ 

Enter your guess: 25 Enter| 

Your guess is too low^_ 

Enter your guess: 42 I 

Your guess is too high_ 

Enter your guess: 39 Enter 
Yes, the number is 39 


intelligent guess 


The magic number is between 0 and 100. To minimize the number of guesses, enter 50 
first. If your guess is too high, the magic number is between 0 and 49. If your guess is too low. 
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the magic number is between 51 and 100. So, after one guess, you can eliminate half the 
numbers from further consideration. 

How do you write this program? Do you immediately begin coding? No. It is important to 
think before coding. Think about how you would solve the problem without writing a pro¬ 
gram. You need to first generate a random number between 0 and 100, inclusive, then prompt 
the user to enter a guess, and then compare the guess with the random number. 

It is a good practice to code incrementally — that is, one step at a time. For programs 
involving loops, if you don’t know how to write a loop right away, you might first write the 
program so it executes the code once, and then figure out how to execute it repeatedly in a 
loop. For this program, you can create an initial draft, as shown in Listing 5.2. 

Listing 5.2 GuessNumberOneTime.py 

1 import random 

2 

3 # Generate a random number to be guessed 

4 number = random. randintfO, 100) 

5 

6 printC'Guess a magic number between 0 and 100") 

7 

8 # Prompt the user to guess the number 

9 guess = eval(i nputf'Enter your guess: ' )) 

10 

11 if guess == number: 

12 printC'Yes, the number is", number) 

13 elif guess > number: 

14 printC'Your guess is too high") 

15 else: 

16 printC'Your guess is too low") 

When this program runs, it prompts the user to enter a guess only once. To let the user 
enter a guess repeatedly, you can change the code in lines 11-16 to create a loop, as follows: 

1 while True: 

2 # Prompt the user to guess the number 

3 guess = eval(i nput("Enter your guess: ' )) 

4 

5 if guess == number: 

6 printC'Yes, the number is", number) 

7 elif guess > number: 

8 printC'Your guess is too high") 

9 el se : 

10 printC'Your guess is too low") 

This loop repeatedly prompts the user to enter a guess. However, the loop still needs to ter¬ 
minate; when guess matches number, the loop should end. So, revise the loop as follows: 

1 while guess != number: 

2 # Prompt the user to guess the number 

3 guess = eval(i nputC'Enter your guess: ')) 

4 

5 if guess == number: 

6 printC'Yes, the number is", number) 

7 elif guess > number: 

8 printC'Your guess is too high") 

9 el se : 

10 printC'Your guess is too low") 


think before coding 

code incrementally 


generate a number 

enter a guess 

correct guess? 
too high? 
too low? 


The complete code is given in Listing 5.3. 
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Listing 5.3 CuessNumber. py 



1 

import random 



£. 

3 

# Generate a random number to be guessed 


generate a number 

4 

C 

number = random. randint(0, 100) 



J 

6 

printC'Cuess a magic number between 0 and 

100 


/ 

8 

guess = 1 



9 

while guess != number: 



10 

# Prompt the user to guess the number 


enter a guess 

11 

guess = eval(i nputC'Enter your guess: 

")) 


12 




13 

if guess == number: 



14 

printC'Yes, the number is", number) 


15 

elif guess > number: 


too high? 

16 

printC'Your guess is too high") 



17 

el se; 


too low? 

18 

printC'Your guess is too low") 






line# 

number 

guess 

output 


4 

39 




8 


-1 


iteration 1 

11 


50 



16 



Your guess is too high 

iteration 2 

11 


25 



18 



Your guess is too low 

iteration 3 

11 


42 



16 



Your guess is too high 

iteration 4 

11 


39 



14 



Yes, the number is 39 


The program generates the magic number in line 4 and prompts the user to enter a guess 
continuously in a loop (lines 9-18). For each guess, the program determines whether 
the user’s number is correct, too high, or too low (lines 13-18). When the guess is correct, 
the program exits the loop (line 9). Note that guess is initialized to -1. This is to avoid 
initializing it to a value between 0 and 100, because that could be the number to be 
guessed. 

5.2.2 Loop Design Strategies 

Writing a loop that works correctly is not an easy task for novice programmers. Consider the 
three steps involved when writing a loop: 

Step 1: Identify the statements that need to be repeated. 

Step 2: Wrap these statements in a loop like this: 

while True: 

Statements 
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Step 3: Code the loop-continuation-condition and add appropriate statements for 
controlling the loop. 

while 1oop-continuation-condition: 

Statements 

Additional statements for controlling the loop 


5.2.3 Case Study: Multiple Subtraction Quiz 

The subtraction quiz program in Listing 4.4, SubtractionQuiz.py, generates just one question 
for each run. You can use a loop to generate questions repeatedly. How do you write the code 
to generate five questions? Follow the loop design strategy. First, identify the statements that 
need to be repeated. These are the statements for obtaining two random numbers, prompting 
the user with a subtraction question, and grading the question. Second, wrap the statements in 
a loop. Third, add a loop-control variable and the loop-continuation-condition to execute the 
loop five times. 

Listing 5.4 is a program that generates five questions and, after a student answers all of 
them, reports the number of correct answers. The program also displays the time spent on the 
test, as shown in the sample run. 


Listing 5.4 Subtracti onQui zLoop. py 

1 import random 

2 import time 

3 

4 correctCount =0 # Count the number of correct answers 

5 count =0 # Count the number of questions 

6 NUMBER_0F_QUESTI0NS = 5 # Constant 

7 

8 startTime = time.timeO # Get start time 

9 

10 while count < NUMBER_0F_QUESTI0NS: 

11 # Generate two random single-digit integers 

12 numberl = random. randintfO, 9) 

13 number2 = random. randintfO, 9) 

14 

15 # If numberl < number2, swap numberl with number2 

16 if numberl < number2: 

17 numberl, number2 = number2, numberl 

18 

19 # Prompt the student to answer "What is numberl - number2?" 

20 answer = eval (i nput("What is " + str(numberl) -i- " - " + 

21 str(number2) -i- "? ")) 

22 

23 # Grade the answer and display the result 

24 if numberl - number2 == answer: 

25 printC'You are correct!") 

26 correctCount += 1 

27 else: 

28 printC'Your answer is wrong.\n'’, numberl, ■ 

29 number2, "is", numberl - number2) 

30 

31 # Increase the count 

32 count += 1 

33 

34 endTime = time.timeO # Get end time 

35 testTime = int(endTime - startTime) # Get test time 

36 pri ntC'Correct count is", correctCount, "out of", 

37 NUMBER_0F_QUESTI0NS, "\nTest time is", testTime, "seconds") 


correct count 
total count 

get start time 
loop 


display a question 


grade an answer 
increase correct count 


increase control variable 

get end time 
test time 
display result 
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What is 1 - 1? 0 

-1 Enter | 

You are correct! 


What is 7 - 2? 5 


You are correct! 


What is 9 - 3? 4 

1 —1 Enter 

Your answer is wrong. 

9 - 3 is 6 


What is 6 - 6? 0 

l^^nte^ 

You are correct! 


What is 9 - 6? 2 

pj Enter 

Your answer is wrong. 

9 - 6 is 3 



Correct count is 3 out of 5 
Test time is 10 seconds 


The program uses the control variable count to control the execution of the loop, count 
is initially 0 (line 5) and is increased by 1 in each iteration (line 32). A subtraction question is 
displayed and processed in each iteration. The program obtains the time before the test starts 
in line 8 and the time after the test ends in line 34, and computes the test time in seconds in 
line 35. The program displays the correct count and test time after all the quizzes have been 
taken (lines 36-37). 


5.2.4 Controlling a Loop with User Confirmation 

The preceding example executes the loop five times. If you want the user to decide whether to 
confirmation take another question, you can offer a user confirmation. The template of the program can be 

coded as follows: 

confinueLoop = Y' 

while continueLoop == 'Y' : 

# Execute the loop body once 


# Prompt the user for confirmation 

continueLoop = input("Enter Y to continue and N to quit: ") 

You can rewrite Listing 5.4 with user confirmation to let the user decide whether to 
advance to the next question. 


5.2.5 Controlling a Loop with a Sentinel Value 

Another common technique for controlling a loop is to designate a special input value, known 
sentinel value as a sentinel value, which signifies the end of the input. A loop that uses a sentinel value in 

sentinel-controlled loop this way is called a sentinel-controlled loop. 

The program in Listing 5.5 reads and calculates the sum of an unspecified number of inte¬ 
gers. The input 0 signifies the end of the input. You don’t need to use a new variable for each 
input value. Instead, use a variable named data (line 1) to store the input value and use a vari¬ 
able named sum (line 5) to store the total. Whenever a value is read, assign it to data (line 9) 
and add it to sum (line 7) if it is not zero. 
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Listing 5.5 SentinelValue.py 

1 data = eval (i nput ("Enter an integer (the input ends " + input data 

2 "if it is 0): ■)) 

3 

4 # Keep reading data until the input is 0 

5 sum = 0 

6 while data != 0: loop 

7 sum += data 

8 

9 data = eval(i nput("Enter an integer (the input ends " + 

10 "if it is 0): ")) 

11 

12 printC'The sum is", sum) outputresult 




Enter 

an integer 

(the 

i nput 

ends 

if 

it 

i s 

0): 

2 


Enter 

an integer 

(the 

i nput 

ends 

if 

it 

i s 

0): 

3 


Enter 

an integer 

(the 

i nput 

ends 

if 

it 

i s 

0): 

4 


Enter 

an integer 

(the 

i nput 

ends 

if 

it 

i s 

0): 

0 

^-1 Enter | 

The sum is 9 











line# 

data 

sum 

output 

1 

2 



5 


0 


iteration 1 f ^ 


2 


1 9 

3 



iteration 2 f ^ 


5 


1 9 

4 



iteration 3 f ^ 


9 


1 9 

0 



12 



The sum is 9 




If data is not 0, it is added to the sum (line 7) and the next item of input data is read (lines 
9-10). If data is 0, the loop body is no longer executed and the while loop terminates. The 
input value 0 is the sentinel value for this loop. Note that if the first input read is 0, the loop 
body never executes, and the resulting sum is 0 . 



Caution 

Don’t use floating-point values for equality checking in a loop control. Since those values are 
approximated, they could lead to imprecise counter values. This example uses i nt value for 
data. Consider the following code for computing 1 + 0.9 + 0.8 -r ... + 0.1: 


item = 1 
sum = 0 


while item != 0: # No guarantee item will be 0 

sum += item 
item -= 0.1 


numeric error 


print(sum) 
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input redirection 


output redirection 


/Check 
L Point 

MyProgrammingLab" 


The variable item starts with 1 and is reduced by 0.1 every time the loop body is 
executed. The loop should terminate when item becomes 0. However, there is no guar¬ 
antee that item will be exactly 0, because the floating-point arithmetic is approximated. 

This loop seems okay on the surface, but it is actually an infinite loop. 

5.2.6 Input and Output Redirections 

In Listing 5.5, if you have a lot of data to enter, it would be cumbersome to type all the entries 
from the keyboard. You can store the data in a text file (named input.txt, for example) and run 
the program by using the following command: 

python SentinelValue.py < input.txt 

This command is called input redirection. Instead of having the user type the data from the 
keyboard at runtime, the program takes the input from the file input.txt. Suppose the file con¬ 
tains the following numbers, one number per line: 

2 

3 

4 
0 

The program should get sum to be 9. 

Similarly, output redirection can send the output to a file instead of displaying it on the 
screen. The command for output redirection is: 

python Script.py > output.txt 

Input and output redirection can be used in the same command. For example, the following 
command gets input from input.txt and sends output to output.txt: 

python SentinelValue.py < input.txt > output.txt 

Run the program and see what contents show up in output.txt. 

5.1 Analyze the following code. Is count < 100 always True, always Fal se, or some¬ 
times True or sometimes Fal se at Point A, Point B, and Point C? 

count = 0 
while count < 100: 

# Point A 

pri ntC'Programming is fun!") 

count += 1 

# Point B 

# Point C 

5.2 What is wrong if guess is initialized to 0 in line 8 in Listing 5.3? 

5.3 How many times are the following loop bodies repeated? What is the printout of each 
loop? 


i = 1 


i = 1 


i = 1 

while i < 10: 


while i < 10: 


while i < 10: 

if i % 2 == 0: 


if i % 2 == 0: 


if i % 2 == 0: 

pri nt(i) 


pri nt(i) 


print(i) 



i 1 


i -H= 1 


(a) (b) (c) 
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5.4 Show the errors in the following code: 


count = 0 


count = 0 


count = 0 

while count < 100: 


while count < 100: 


while count < 100: 

pri nt(count) 


pri nt(count) 


count += 1 



count 1 




(a) (b) (c) 


5.5 Suppose the input is 2 3 4 5 0 (one number per line). What is the output of the fol¬ 
lowing code? 

number = eval(i nput("Enter an integer: ")) 
max = number 

while number != 0: 

number = eval(i nput("Enter an integer: ")) 
if number > max: 
max = number 

printf'max is", max) 
pri ntC'number" , number) 

5.3 The for Loop 

A Python for loop iterates through each value in a sequence. 

Often you know exactly how many times the loop body needs to be executed, so a control 
variable can be used to count the executions. A loop of this type is called a counter-controlled 
loop. In general, the loop can be written as follows: 

i = initial Value # Initialize loop-control variable 
while i < endValue: 

# Loop body 

i += 1 # Adjust loop-control variable 

A for loop can be used to simplify the preceding loop: 

for i in range(initialValue, endValue): 

# Loop body 

In general, the syntax of a for loop is: for loop 

for var in sequence: 

# Loop body 

A sequence holds multiple items of data, stored one after the other. Later in the book, we 
will introduce strings, lists, and tuples. They are sequence-type objects in Python. The vari¬ 
able var takes on each successive value in the sequence, and the statements in the body of the 
loop are executed once for each value. 

The function range (a, b) returns the sequence of integers a, a -i- 1, ..., b - 2, and b - range (a, b) function 
1. For example. 



tr/Key 
r (Point 

counter-controlled loop 
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»> for V in range(4, 8): 
print(v) 

4 

5 

6 
7 

»> 


range (a) function 
range (a, b, k) function 
step value 


The range function has two more versions. You can also use range (a) or range (a, b, 
k) . range (a) is the same as range (0, a).kis used as step vaZwe in r ange (a, b, k) . The 
first number in the sequence is a. Each successive number in the sequence will increase by the 
step value k. b is the limit. The last number in the sequence must be less than b. For example, 



»> for V in range(3, 9, 2): 
print(v) 


3 

5 

7 

»> 


count backward 


The Step value in range (3, 9, 2) is 2, and the limit is 9. So, the sequence is 3, 5, and 7. 
The range (a, b, k) function can count backward if k is negative. In this case, the 
sequence is still a, a + k, a + 2 k, and so on for a negative k. The last number in the 
sequence must be greater than b. For example. 


»> for V in range(5, 1, -1): 
print(v) 

5 

4 

3 

2 

»> 



Note 

The numbers in the range function must be integers. For example, rangefl.S, 
8.5), range(8.5), or rangefl. 5 , 8.5, 1) would be wrong. 


/Check 
{. Point 


Suppose the input is 2 3 4 5 0 (one number per line). What is the output of the fol¬ 
lowing code? 


MyProgrammingLab" 


number = 0 
sum = 0 


for count in range(5): 

number = eval(i nput("Enter an integer: ")) 
sum += number 


printC'sum is", sum) 
printC'count is", count) 

5.7 Can you convert any for loop to a wh i 1 e loop? Fist the advantages of using for loops. 
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5.8 Convert the following for loop statement to a whil e loop: 
sum = 0 

for i in range(lOOl): 
sum = sum + i 

5.9 Can you always convert any while loop into a for loop? Convert the following 
while loop into a for loop. 

i = 1 
sum = 0 

while sum < 10000: 

sum = sum + i 
i += 1 

5.10 Count the number of iterations in the following loops: 


count = 0 


for count in rangeCn): 

while count < n: 


printCcount) 

count += 1 




(a) (b) 


count = 5 


count = 5 

while count < n: 


while count < n: 

count += 1 


count = count + 3 


(c) (d) 


5.4 Nested Loops 

A loop can be nested inside another loop. 

Nested loops consist of an outer loop and one or more inner loops. Each time the outer loop is 
repeated, the inner loops are reentered and started anew. 

Listing 5.6 presents a program that uses nested for loops to display a multiplication table. 

Listing 5.6 Mul ti pi i cati onTabl e. py 

1 printC' Multiplication Table") 

2 # Display the number title 

3 printC" I", end = ") 

4 for j in rangefl, 10): 

5 printC , j, end = ' ') 

6 printC) # lump to the new line 

7 printC" --- - ") 

8 

9 # Display table body 

10 for i in rangeCl, 10): 

11 printCi, , end = ") 

12 for j in rangeCl, 10): 

13 # Display the product and align properly 

14 printCformatCi * j, "4d") , end = '') 

15 printC) # lump to the new line 


rr/Key 
ITL* Point 

nested loops 

table title 


table body 
nested loop 


display a line 
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Muiti piication 

Tabl e 





1 

2 

3 

4 

5 

6 

7 

8 

9 

1 

1 

1 

2 

3 

4 

5 

6 

7 

8 

9 

2 

1 

2 

4 

6 

8 

10 

12 

14 

16 

18 

3 

1 

3 

6 

9 

12 

15 

18 

21 

24 

27 

4 

1 

4 

8 

12 

16 

20 

24 

28 

32 

36 

5 

1 

5 

10 

15 

20 

25 

30 

35 

40 

45 

6 

1 

6 

12 

18 

24 

30 

36 

42 

48 

54 

7 

1 

7 

14 

21 

28 

35 

42 

49 

56 

63 

8 

1 

8 

16 

24 

32 

40 

48 

56 

64 

72 

9 

1 

9 

18 

27 

36 

45 

54 

63 

72 

81 



The program displays a title (line 1) on the first line in the output. The first for loop 
(lines 4-5) displays the numbers 1 through 9 on the second line. A line of dashes (-) is dis¬ 
played on the third line (line 7). 

The next loop (lines 10-15) is a nested for loop with the control variable i in the outer 
loop and j in the inner loop. For each i , the product i j is displayed on a line in the inner 
loop, with j being 1, 2, 3, . . ., 9. 

To align the numbers properly, the program formats 1 * j using format Ci * j, "4d") 
(line 14). Recall that "4d'' specifies a decimal integer format with width 4. 

Normally, the print function automatically jumps to the next line. Invoking 
end = '' print(item, end = ' (lines 3, 5, 11, and 14) prints the item without advancing to the 

next line. Note that the print function with the end argument was introduced in Section 3.3.5. 


Note 

Be aware that a nested loop may take a long time to run. Consider the following loop 
nested in three levels: 

for i in range(lOOO): 

for j in range(lOOO): 

for k in range(lOOO): 

Perform an action 

The action is performed 1,000,000,000 times. If it takes I millisecond to perform the 
action, the total time to run the loop would be more than 277 hours. 


/Check 
{. Point 


5.11 Show the output of the following programs. (Hint: Draw a table and list the variables 
in the columns to trace these programs.) 


MyProgrammingLab" 


(a) (b) 


i = 5 


i = 1 

while i >= 1: 


while i <= 5: 

num = 1 


num = 1 

for j in range(l, i +1): 


for j in rangefl, i + 1) : 

printfnum, end = "xxx") 


print(num, end = "C") 

num *= 2 


num += 2 

pri nt() 


pri nt() 

i -= 1 


i += 1 


(c) (d) 


for i in range (1, 5): 
j = 0 

while j < i: 

printCj, end = " ") 
j += 1 


i = 0 

while i < 5: 

for j in rangefi , 1, -1): 

pri nt(j , end = " ") 
print( '■"***") 
i += 1 
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5.5 Minimizing Numerical Errors 

Using floating-point numbers in the loop-continuation-condition may cause numeric errors. 

Numerical errors involving floating-point numbers are inevitable. This section provides an 
example showing you how to minimize such errors. 

The program in Listing 5.7 sums a series that starts with 0.01 and ends with 1.0. The 
numbers in the series will increment by 0.01, as follows: 0.01 + 0.02 + 0.03 and so on. 


c/k, 
P ^Poi 


Key 

Point 


Listing 5.7 TestSum.py 


1 # Initialize sum 

2 sum = 0 

3 

4 # Add 0.01, 0.02, ..., 0.99, 1 to sum 

5 i = 0.01 

6 while i <= 1.0: loop 

7 sum += i 

8 i = i + 0.01 

9 

10 # Display result 

11 printC'The sum is", sum) 


The sum is 49.5 


The result displayed is 49.5, but the correct result is actually 50.5. What went wrong? For numeric error 
each iteration in the loop, i is incremented by 0.01. When the loop ends, the i value is slightly 
larger than 1 (not exactly 1). This causes the last i value not to be added into sum. The funda¬ 
mental problem is that the floating-point numbers are represented by approximation. 

To fix the problem, use an integer count to ensure that all the numbers are added to sum. 

Here is the new loop: 

# Initialize sum 
sum = 0 


# Add 0.01, 0.02, ..., 0.99, 1 to sum 
count = 0 

i = 0.01 

while count < 100: 
sum += i 
i = i + 0.01 

count += 1 # Increase count 

# Display result 
printC'The sum is", sum) 

Or, use a for loop as follows: 

# Initialize sum 
sum = 0 

# Add 0.01, 0.02, ..., 0.99, 1 to sum 

i = 0.01 

for count in range(lOO): 
sum += i 
i = i + 0.01 


# Display result 
printC'The sum is", sum) 


After this loop, sum is 50.5. 
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GCD 


input 

input 

gcd 


output 


5.6 Case Studies 




Loops are fundamental in programming. The ability to write loops is essential in 
learning programming. 


If you can write programs using loops, you know how to program! For this reason, this section 
presents three additional examples of solving problems using loops. 


5.6.1 Problem: Finding the Greatest Common Divisor 

The greatest common divisor (GCD) of the two integers 4 and 2 is 2. The greatest common 
divisor of the two integers 16 and 24 is 8. How do you find the greatest common divisor? Let 
the two input integers be nl and n2. You know that number 1 is a common divisor, but it may 
not be the greatest common divisor. So you can check whether k (for k = 2,3,4, and so on) 
is a common divisor for nl and n2, until k is greater than nl or n2. Store the common divisor 
in a variable named gcd. Initially, gcd is 1. Whenever a new common divisor is found, it 
becomes the new gcd. When you have checked all the possible common divisors from 2 up to 
nl or n2, the value in the variable gcd is the greatest common divisor. The idea can be trans¬ 
lated into the following loop: 

gcd = 1 # Initial gcd is 1 
int k = 2 # Possible gcd 
while k <= nl and k <= n2: 

if nl % k == 0 and n2 % k == 0: 
gcd = k 

k += 1 # Next possible gcd 

# After the loop, gcd is the greatest common divisor for nl and n2 

Listing 5.8 presents a program that prompts the user to enter two positive integers and 
finds their greatest common divisor. 

Listing 5.8 GreatestCommonDi vi sor. py 

1 # Prompt the user to enter two integers 

2 nl = eval(i nputC'Enter first integer: ")) 

3 n2 = eval(i nputC'Enter second integer: ")) 

4 

5 gcd = 1 

6 k = 2 

7 while k <= nl and k <= n2: 

8 if nl % k == 0 and n2 % k == 0: 

9 gcd = k 

10 k += 1 

11 

12 printC'The greatest common divisor for", 

13 nl, "and", n2, "is", gcd) 



Enter first integer: 125 
Enter second integer: 2525 

The greatest common divisor for 125 and 2525 is 25 


think before you type 


How would you approach writing this program? Would you immediately begin to write the 
code? No. It is important to think before you type. Thinking enables you to generate a logical 
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solution for the problem without wondering how to write the code. Once you have a logical 
solution, type the code to translate the solution into a program. 

A problem often has multiple solutions. The GCD problem can be solved in many ways. 
Exercise 5.16 at the end of this chapter suggests another solution. A more efficient solution is 
to use the classic Euclidean algorithm. See www.cut-the-knot.org/blue/Euclid.shtml for more 
information. 

5.12 If you think that a divisor for a number nl cannot be greater than nl / 2, you might 
attempt to improve the program using the following loop: 

k = 2 

while k <= nl / 2 and k <= n2 / 2 : 
if nl % k == 0 and n2 % k == 0: 

gcd = k 
k += 1 

This revision is wrong. Can you find the reason? 

5.6.2 Problem: Predicting the Future Tuition 

Suppose that the tuition for a university is $10,000 this year and increases 7% every year. In 
how many years will the tuition have doubled? 

Before you attempt to write a program, first consider how to solve this problem by hand. 
The tuition for the second year is the tuition for the first year * 1.07. The tuition for a future 
year is the tuition of its preceding year * 1.07. So, the tuition for each year can be computed 


as follows: 




year = 0 

# Year 0 


tuition 

= 

10000 


year += 

1 

# Year 1 


tuition 

= 

tuition * 

1.07 

year -h= 

1 

# Year 2 


tuition 

= 

tuition * 

1.07 

year -h= 

1 

# Year 3 


tuition 

= 

tuition * 

1.07 


Keep computing tuition for a new year until it is at least 20000. By then you will know 
how many years it will take for the tuition to be doubled. You can now translate the logic into 
the following loop: 

year =0 # Year 0 

tuition = 10000 
while tuition < 20000: 
year += 1 

tuition = tuition * 1.07 
The complete program is shown in Listing 5.9. 

Listing 5.9 FutureTuition.py 

1 year =0 # Year 0 

2 tuition = 10000 # Year 1 

3 

4 while tuition < 20000: 


multiple solutions 
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next year’s tuition 


5 year += 1 

6 tuition = tuition * 1.07 

7 

8 pri ntC'Tuition will be doubled in", year, "years") 

9 printC'Tuition will be $" + format(tuition, ".2f"), 

10 "in", year, "years") 


Tuition will be doubled in 11 years 
Tuition will be $21048.52 in 11 years 


The while loop (lines 4—6) is used to repeatedly compute the tuition for a new year. The 
loop terminates when tuition is greater than or equal to 20000. 


5.6.3 Problem: Monte Carlo Simulation 

A Monte Carlo simulation uses random numbers and probability to solve problems. It has a 
wide range of applications in computational mathematics, physics, chemistry, and finance. 
We now look at an example of using a Monte Carlo simulation for estimating tt. 

First, draw a circle with its bounding square. 

y 



l ' 






-1 



1 


-1 



Assume the radius of the circle is 1. So, the circle area is rr and the square area is 4. Ran¬ 
domly generate a point in the square. The probability that the point falls in the circle is 

circleArea / squareArea = 7t / 4. 

Write a program that randomly generates 1000000 points that fall in the square and let 
numberOfHits denote the number of points that fall in the circle. So, numberOfHits is 
approximately 1000000 * (ti / 4). tt can be approximated as 4 * numberOfHits / 
1000000. The complete program is shown in Listing 5.10. 

Listing 5.10 MonteCarloSimulation.py 

1 import random 

2 

3 NUMBER_0F_TRIALS = 1000000 # Constant 

4 numberOfHits = 0 

5 

6 for i in range(NUMBER_0F_TRIALS): 


generate random points 

7 

8 

9 

10 

X = random. randomO 
y = random. randomO 

*2-1 

*2-1 

check inside circle 

if X * X + y * y <= 

1: 


11 

numberOfHits += 

1 


12 



estimate pi 

13 

pi = 4 * numberOfHits / 

NUMBER_0F_TRIALS 


14 

15 

printC'PI is", pi) 



PI 

is 3.14124 
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The program repeatedly generates a random point (x, y) in the square in lines 7-8: 

X = random. randomO * 2 - 1 
y = random. randomO * 2 - 1 

Recall that randomC) returns a random float r such that 0 <= r < 1.0. 

If < 1, the point is inside the circle and numberOfHits is incremented by 1. tt 

is approximately 4 * numberOfHits / NUMBER_OF_TRIALS (line 13). 


5.7 Keywords break and continue 

The break and continue keywords provide additional controls to a loop. 



Pedagogical Note 

Two keywords, break and continue, can be used in loop statements to provide addi¬ 
tional controls. Using break and continue can simplify programming in some cases. 
Overusing or improperly using them, however, can make programs difficult to read and 
debug. (Note to readers'. You may skip this section without affecting your understanding 
of the rest of the book.) 


Key 
I Point 


You can use the keyword break in a loop to immediately terminate a loop. Listing 5.11 break keyword 
presents a program to demonstrate the effect of using break in a loop. 


Listing 5.11 TestBreak.py 

1 sum = 0 

2 number = 0 

3 

4 while number < 20: 

5 number += 1 

6 sum -F= number 

7 if sum >= 100: 

8 f - break break out of the loop 

9 ^ 

10 printC'The number is", number) 

11 printC'The sum is", sum) 


The number is 14 
The sum is 105 



The program adds integers from 1 to 20 in this order to sum until sum is greater than or 
equal to 100. Without lines 7-8, this program would calculate the sum of the numbers from 1 
to 20. But with lines 7-8, the loop terminates when sum becomes greater than or equal to 100. 
Without lines 7-8, the output would be: 


The number is 20 
The sum is 210 



You can also use the continue keyword in a loop. When it is encountered, it ends the cur- conti nue statement 
rent iteration and program control goes to the end of the loop body. In other words, continue 
breaks out of an iteration, while the break keyword breaks out of a loop. The program in 
Listing 5.12 shows the effect of using continue in a loop. 
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jump to the end of the 
iteration 





Listing 5.12 TestContinue.py 

1 sum = 0 

2 number = 0 

3 

4 while number < 20: 

5 number += 1 

6 if number == 10 or number == 11: 



10 printC'The sum is", sum) 


The sum is 189 


The program adds all the integers from 1 to 20 except 10 and 11 to sum. The continue 
statement is executed when number becomes 10 or 11. The continue statement ends the 
current iteration so that the rest of the statement in the loop body is not executed; therefore, 
number is not added to sum when it is 10 or 11. 

Without lines 6 and 7, the output would be as follows: 


The sum is 210 


In this case, all the numbers are added to sum, even when number is 10 or 11. Therefore, 
the result is 210. 

You can always write a program without using break or continue in a loop (see Check¬ 
point Question 5.15). In general, it is appropriate to use break and continue if their use 
simplifies coding and makes programs easy to read. 

Suppose you need to write a program to find the smallest factor other than 1 for an integer 
n (assume n >= 2). You can write a simple and intuitive code using the break statement as 
follows: 

n = eval(i nputC'Enter an integer >= 2: ")) 

factor = 2 

while factor <= n: 

if n % factor == 0: 


break 


factor += 1 

printC'The smallest factor other than 1 for", n, "is", factor) 

You may rewrite the code without using break as follows: 

n = eval(i nputC'Enter an integer >= 2: ")) 
found = False 
factor = 2 

while factor <= n and not found: 
if n % factor == 0: 

found = True 
else: 

factor += 1 

printC'The smallest factor other than 1 for", n, "is", factor) 


jump to the end of the 
iteration 





Obviously, the break statement makes the program simpler and easier to read in this 
example. However, you should use break and continue with caution. Too many break 
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and continue statements will produce a loop with many exit points and make the pro¬ 
gram difficult to read. 


Note 

Some programming languages have a goto statement. The goto statement indiscrimi¬ 
nately transfers control to any statement in the program and executes it. This makes 
your program vulnerable to errors. The break and conti nue statements in Python are 
different from goto statements. They operate only in a loop statement. The break 
statement breaks out of the loop, and the continue statement breaks out of the cur¬ 
rent iteration in the loop. 

5.13 What is the keyword break for? What is the keyword continue for? Will the fol¬ 
lowing program terminate? If so, give the output. 


balance = 1000 


balance = 1000 

while True: 


while True: 

if balance < 9: 


if balance < 9: 

break 


continue 

balance = balance - 9 


balance = balance - 9 

pri ntC'Balance is", balance) 


pri ntC'Balance is", balance) 


(a) (b) 


5.14 The for loop on the left is converted into the while loop on the right. What is 
wrong? Correct it. 



5.15 Rewrite the programs TestBreak and TestContinue in Listings 5.11 and 5.12 
without using break and continue statements. 

5.16 After the break statement in (a) is executed in the following loop, which statement is 
executed? Show the output. After the continue statement in (h) is executed in the 
following loop, which statement is executed? Show the output. 


for i in rangefl, 4): 


for i in range (1, 4): 

for j in rangefl , 4) : 


for j in range (1, 4): 

if i * j > 2: 


if i * j > 2: 

break 


continue 

printfi * j) 


printCi * j) 

pri nt(i) 


pri nt(i) 


(a) (b) 


goto 


iraeck 
W Point 

MyProgrammingLab" 
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5.8 Case Study: Displaying Prime Numbers 

This section presents a program that displays the first fifty prime numbers in five lines, 
each containing ten numbers. 


An integer greater than 1 is prime if its only positive divisor is 1 or itself. For example, 2,3, 
5, and 7 are prime numbers, but 4, 6, 8, and 9 are not. 

The problem can be broken into the following tasks: 


■ Determine whether a given number is prime. 

■ For number = 2, 3, 4, 5, 6, ..., test whether the number is prime. 

■ Count the prime numbers. 

■ Display each prime number, and display ten numbers per line. 


Obviously, you need to write a loop and repeatedly test whether a new number is prime. If 
the number is prime, increase the count by 1. The count is 0 initially. When it reaches 50, the 
loop terminates. 

Here is the algorithm for the problem: 

Set the number of prime numbers to be displayed as 
a constant NUMBER OF^PRIMES 
Use count to track the number of prime numbers and 
set an initial count to 
Set an initial number to 2 


while count < NUMBER_OF^PRIMES: 

Test if number is prime 

if number is prime: 

Display the prime number and increase count 
Increment number by 1 

To test whether a number is prime, check whether it is divisible by 2, 3, 4, ..., up to 
number/2. If a divisor is found, the number is not a prime. The algorithm can be described as 
follows: 


Use a Boolean variable isPrime to denote whether 

the number is prime; Set isPrime to True initially 

for divisor in range(2, number / 2 + 1) : 
if number % divisor == 0: 

Set isPrime to False 
Exit the loop 

The complete program is given in Listing 5.13. 


count prime numbers 


Listing 5.13 PrimeNumber.py 

1 NUMBER_OF_PRIMES = 50 # Number of primes to display 

2 NUMBER_OF_PRIMES_PER_LINE = 10 # Display 10 per line 

3 count =0 # Count the number of prime numbers 

4 number =2 # A number to be tested for primeness 

5 

6 printC'The first 50 prime numbers are') 

7 

8 # Repeatedly find prime numbers 
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9 

while count < NUMBER_0F_PRIMES: 


10 

# Assume the number is prime 


11 

isPrime = True # Is the current number prime? 

12 



13 

# Test if number is prime 


14 

divisor = 2 


15 

while divisor <= number / 2: 


16 

if number % divisor == 0: 


17 

# If true, the number is not prime 


18 

isPrime = False # Set isPrime to false 

19 

break # Exit the for loop 


20 

divisor += 1 


21 



22 

# Display the prime number and increase the 

count 

23 

if isPrime: 


24 

count += 1 # Increase the count 


25 



26 

print(format(number, "Sd"), end = 


27 

if count % NUMBER_OF_PRIMES_PER_LINE == 

0: 

28 

# Display the number and advance to 

the new 

29 

printO # lump to the new line 


30 



31 

# Check if the next number is prime 


32 

number -h= 1 



check primeness 


exit loop 


display if prime 


The 

fi rst 

50 prime 

numbers 

are 





2 

3 

5 

7 

11 

13 

17 

19 

23 

29 

31 

37 

41 

43 

47 

53 

59 

61 

67 

71 

73 

79 

83 

89 

97 

101 

103 

107 

109 

113 

127 

131 

137 

139 

149 

151 

157 

163 

167 

173 

179 

181 

191 

193 

197 

199 

211 

223 

227 

229 



This is a complex example for novice programmers. The key to developing a program¬ 
matic solution for this problem—and for many other problems—is to break it into sub¬ 
problems and develop solutions for each of them in turn. Do not attempt to develop a 
complete solution in the first trial. Instead, begin by writing the code to determine whether 
a given number is prime, and then expand the program to test whether other numbers are 
prime in a loop. 

To determine whether a number is prime, check whether it is divisible by a number 
between 2 and number/2 inclusive. If so, it is not a prime number; otherwise, it is a prime 
number. For a prime number, display it. If the count is divisible by 10, advance to a new line. 
The program ends when the count reaches 50. 

The program uses the break statement in line 19 to exit the for loop as soon as the num¬ 
ber is found to be a nonprime. You can rewrite the loop (lines 15-20) without using the break 
statement as follows: 

while divisor <= number / 2 and isPrime: 
if number % divisor == 0: 

# If True, the number is not prime 
isPrime = False # Set isPrime to False 
divisor += 1 

However, using the break statement makes the program simpler and easier to read in 
this case. 
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5.9 Case Study: Random Walk 

You can use Turtle graphics to simulate a random walk. 

In this section, we will write a Turtle program that simulates a random walk in a lattice (e.g., 
like walking around a garden and turning to look at certain flowers) that starts from the center 
and ends at a point on the boundary, as shown in Figure 5.2. Listing 5.14 gives the program. 



TlSt Python Turtle Graphics [ i 











Figure 5.2 The program simulates random walks in a lattice. 


Listing 5.14 RandomWal k.py 


import turtle 

1 

import turtle 

import randi nt 

2 

■2 

from random import randint 

set turtl e speed 

J 

4 

C 

turtle. speed(l) # Set turtle speed to slowest 


J 

6 

# Draw 16-by-16 lattice 

set color 

7 

turtle. colorC'gray") # Color for lattice 


8 

X = -80 

draw horizontal lines 

9 

for y in range(-80, 80 + 1, 10): 


10 

turtl e. penupO 


11 

turtle.gotofx, y) # Draw a horizontal line 


12 

turtle.pendownO 


13 

14 

turtle.forward (160) 


15 

y = 80 

draw vertical lines 

16 

turtle.ri ght(90) 


17 

for X in range( «0, 80 + 1, 10): 


18 

turtl e. penupO 


19 

turtle.goto(x, y) # Draw a vertical line 


20 

turtle.pendownO 


21 

22 

turtle.forward (160) 


23 

turtle.pens! ze(3) 


24 

25 

turtle.col or ("red") 


26 

turtl e. penupO 

move to center 

27 

turtle. goto(0, 0) # Co to the center 


28 

29 

turtl e. pendownO 

current position 

30 

X = y = 0 # Current pen location at the center of lattice 

check boundaries 

31 

while abs(x) < 80 and abs(y) < 80: 


32 

r = randint(0, 3) 


33 

if r == 0: 

walk east 

34 

X += 10 # Walk right 
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35 turtle. setheading(O) 

36 turtle. forward(lO) 

37 elif r == 1: 

38 y -= 10 # Walk down 

39 turtle. setheading(270) 

40 turtle. forward(lO) 

41 elif r == 2: 

42 X -= 10 # Walk left 

43 turtle.setheading (180) 

44 turtle. forward(lO) 

45 elif r == 3: 

46 y += 10 # Walk up 

47 turtle.setheading (90) 

48 turtle. forward(lO) 

49 

50 turtl e. doneO 

Assume the size of the lattice is 16 by 16 and the distance between two lines in the lattice 
is 10 pixels (lines 6-21). The program first draws the lattice in a gray color. It sets the color to 
gray (line 7), uses the for loop (lines 9-13) to draw the horizontal lines, and the for loop 
(lines 17-21) to draw the vertical lines. 

The program moves the pen to the center (line 27), and starts to simulate a random walk 
in a while loop (lines 31-48). The variables x and y are used to track the current position in 
the lattice. Initially, it is at (0, 0) (line 30). A random number from 0 to 3 is generated in line 
32. These four numbers each correspond to a direction: east, south, west, and north. Con¬ 
sider four cases: 

■ If a walk is to the east, x is increased by 10 (line 34) and the pen is moved to the right 
(lines 35-36). 

■ If a walk is to the south, y is decreased by 10 (line 38) and the pen is moved down¬ 
ward (lines 39-40). 

■ If a walk is to the west, x is decreased by 10 (line 42) and the pen is moved to the left 
(lines 43-44). 

■ If a walk is to the north, y is increased by 10 (line 46) and the pen is moved upward 
(lines 47-48). 

The walk stops when abs(x) or abs(y) is 80 (i.e., the walk reaches the boundary of the 
lattice). 

A more interesting walk is called a self-avoiding walk. It is a random walk in a lattice that 
does not visit the same point twice. You will learn how to write a program to simulate a self¬ 
avoiding walk later in the book. 


Key Terms 


break keyword 151 

loop body 134 

condition-controlled loop 134 

1oop-continuation- 

continue keyword 151 

condition 134 

count-controlled loop 134 

nested loop 145 

infinite loop 135 

off-by-one error 135 

input redirection 142 

output redirection 142 

iteration 134 

sentinel value 140 

loop 134 



walk south 


walk west 


walk north 


pause 
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Chapter Summary 

1 . There are two types of repetition statements: the while loop and the for loop. 

2. The part of the loop that contains the statements to be repeated is called the loop 
body. 

3. A one-time execution of a loop body is referred to as an iteration of the loop. 

4. An infinite loop is a loop statement that executes infinitely. 

5. In designing loops, you need to consider both the loop-control structure and the loop 
body. 

6. The while loop checks the loop-continuation-condition first. If the condi¬ 
tion is true, the loop body is executed; otherwise, the loop terminates. 

7. A sentinel value is a special value that signifies the end of the input. 

8. The for loop is a count-controlled loop and is used to execute a loop body a pre¬ 
dictable number of times. 

9. Two keywords, break and continue, can be used in a loop. 

10. The break keyword immediately ends the innermost loop, which contains the break. 

I I . The conti nue keyword ends only the current iteration. 

Test Questions 

Do test questions for this chapter online at www.cs.armstrong.edu/liang/py/test.html. 
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Pedagogical Note 

For each problem, read it several times until you understand it. Think how to solve 
the problem before coding. Translate your logic into a program. 

A problem often can be solved in many different ways. You should explore various 
solutions. 

Sections 5.2-5.7 

*5.1 {Count positive and negative numbers and compute the average of numbers) 
Write a program that reads an unspecified number of integers, determines 
how many positive and negative values have been read, and computes the total 
and average of the input values (not counting zeros). Your program ends with the 
input 0. Display the average as a floating-point number. Here is a sample run: 




Enter 

an 

i nteger, 

the 

i nput 

ends 

if 

it 

i s 

0 

1 


Enter 

an 

integer, 

the 

i nput 

ends 

if 

it 

i s 

0 

2 


Enter 

an 

i nteger, 

the 

i nput 

ends 

if 

it 

i s 

0 

-1 

[■-1 Enter | 

Enter 

an 

integer, 

the 

i nput 

ends 

if 

it 

i s 

0 

3 

J.-I Enter 


read and think before coding 
explore solutions 
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Enter an integer, the input ends if it is 0: 0 |^Enter 

The number of positives is 3 

The number of negatives is 1 

The total is 5 

The average is 1.25 




Enter an integer, the input ends if it is 0: 0 1 

You didn't enter any number 


5.2 {Repeat additions) Listing 5.4, SubtractionQuizLoop.py, generates five random 
subtraction questions. Revise the program to generate ten random addition ques¬ 
tions for two integers between 1 and 15. Display the correct count and test time. 

5.3 {Conversion from kilograms to pounds) Write a program that displays the follow¬ 
ing table (note that 1 kilogram is 2.2 pounds): 

Kilograms Pounds 

1 2.2 

3 6.6 

197 433.4 

199 437.8 

5.4 {Conversion from miles to kilometers) Write a program that displays the following 
table (note that 1 mile is 1.609 kilometers): 

Miles Kilometers 

1 1.609 

2 3.218 

9 15.481 

10 16.090 

*5.5 {Conversion from kilograms to pounds and pounds to kilograms) Write a program 


that displays the following two tables side by side (note that 1 kilogram is 2.2 

pounds and that 1 pound is .45 kilograms): 


Ki lograms 

Pounds 1 

Pounds 

Ki 1ograms 

1 

2.2 1 

20 

9.09 

3 

6.6 1 

25 

11.36 

197 

433.4 1 

510 

231.82 

199 

437.8 

515 

235.09 

{Conversion from miles to kilometers and kilometers to miles) Write a program 
that displays the following two tables side by side (note that 1 mile is 1.609 kilo- 

meters and that 1 kilometer is 

.621 mile): 


Mi 1 es 

Ki 1ometers 

1 Kilometers 

Miles 

1 

1.609 

1 20 

12.430 

2 

3.218 

1 25 

15.538 

9 

15.481 

1 60 

37.290 

10 

16.090 

1 65 

40.398 
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5.7 {Use trigonometric functions) Print the following table to display the sin value 
and cos value of degrees from 0 to 360 with increments of 10 degrees. Round the 
value to keep four digits after the decimal point. 


Degree 

Si n 

Cos 

0 

0.0000 

1.0000 

10 

0.1736 

0.9848 

350 

-0.1736 

0.9848 

360 

0.0000 

1.0000 


5.8 {Use the math.sqrt function) Write a program that prints the following table 
using the sqrt function in the math module. 

Number Square Root 

0 0.0000 

2 1.4142 

18 5.2426 

20 5.4721 

**5.9 {Financial application: compute future tuition) Suppose that the tuition for a uni¬ 
versity is $10,000 this year and increases 5% every year. Write a program that 
computes the tuition in ten years and the total cost of four years’ worth of tuition 
starting ten years from now. 

5.10 {Find the highest score) Write a program that prompts the user to enter the number 
of students and each student’s score, and displays the highest score. Assume that 
the input is stored in a file named score.txt, and the program obtains the input from 
the file. 

*5.11 {Find the two highest scores) Write a program that prompts the user to enter the 
number of students and each student’s score, and displays the highest and second- 
highest scores. 

5.12 {Find numbers divisible by 5 and 6) Write a program that displays, ten numbers 
per line, all the numbers from 100 to 1,000 that are divisible by 5 and 6. The num¬ 
bers are separated by exactly one space. 

5.13 {Find numbers divisible by 5 or 6, but not both) Write a program that displays, ten 
numbers per line, all the numbers from 100 to 200 that are divisible by 5 or 6, but 
not both. The numbers are separated by exactly one space. 

5.14 {Find the smallest n such that > 72,000) Use a while loop to find the smallest 
integer n such that is greater than 12,000. 

5.15 {Find the largest n such that rf < 12,000) Use a while loop to find the largest 
integer n such that is less than 12,000. 

*5.16 {Compute the greatest common divisor) For Listing 5.8, another solution to find 
the greatest common divisor of two integers nl and n2 is as follows: First find d to 
be the minimum of nl and n2, and then check whether d, d - 1, d - 2, ..., 2, or 
1 is a divisor for both nl and n2 in this order. The first such common divisor is the 
greatest common divisor for nl and n2. 

Section 5.8 

*5.17 {Display the ASCII character table) Write a program that displays the characters 
in the ASCII character table from ! to ~. Display ten characters per line. The char¬ 
acters are separated by exactly one space. 
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**5.18 {Find the factors of an integer) Write a program that reads an integer and displays 
all its smallest factors, also known as prime factors. For example, if the input inte¬ 
ger is 120, the output should be as follows: 

2, 2, 2, 3, 5 

**5.I9 {Display a pyramid) Write a program that prompts the user to enter an integer 
from 1 to 15 and displays a pyramid, as shown in the following sample run: 




*5.20 {Display four patterns using loops) Use nested loops that display the following 
patterns in four separate programs: 


Pattern 

A 

Pattern 

B 

Pattern 

C 


Pattern 

D 

1 


1 

2 

3 

4 

5 6 




1 

1 

2 

3 

4 

5 6 

1 2 


1 

2 

3 

4 

5 



2 

1 

1 

2 

3 

4 

5 

12 3 


1 

2 

3 

4 



3 

2 

1 

1 

2 

3 

4 


12 3 4 


1 

2 

3 



4 

3 

2 

1 

1 

2 

3 



12 3 4 

5 

1 

2 




5 4 

3 

2 

1 

1 

2 




12 3 4 

5 6 

1 





6 5 4 

3 

2 

1 

1 






**5.21 {Display numbers in a pyramid pattern) Write a nested for loop that displays the 
following output: 

1 

12 1 






1 

2 

4 

2 

1 









1 

2 

4 

8 

4 

2 

1 







1 

2 

4 

8 

16 

8 

4 

2 

1 





1 

2 

4 

8 

16 

32 

16 

8 

4 

2 

1 



1 

2 

4 

8 

16 

32 

64 

32 

16 

8 

4 

2 

1 


1 2 

4 

8 

16 

32 

64 

128 

64 

32 

16 

8 

4 

2 

1 


*5.22 {Display prime numbers between 2 and 1,000) Modify Listing 5.13 to display all 
the prime numbers between 2 and 1,000, inclusive. Display eight prime numbers 
per line. 


Comprehensive 

**5.23 {Financial application: compare loans with various interest rates) Write a pro¬ 
gram that lets the user enter the loan amount and loan period in number of years 
and displays the monthly and total payments for each interest rate starting from 
5% to 8%, with an increment of 1/8. Here is a sample run: 
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Loan Amount: 10000 Center| 


Number of Years: 

5 1 -1 Enter j 


Interest Rate 

Monthly Payment 

Total Payment 

5.000% 

188.71 

11322.74 

5.125% 

189.28 

11357.13 

5.250% 

189.85 

11391.59 

7.875% 

202.17 

12129.97 

8.000% 

202.76 

12165.83 


For the formula to compute monthly payment, see Listing 2.8, ComputeLoan.py. 
** 5.24 {Financial application: loan amortization schedule) The monthly payment for a 
given loan pays the principal and the interest. The monthly interest is computed hy 
multiplying the monthly interest rate and the balance (the remaining principal). 
The principal paid for the month is therefore the monthly payment minus the 
monthly interest. Write a program that lets the user enter the loan amount, number 
of years, and interest rate, and then displays the amortization schedule for the loan. 
Here is a sample run: 



Loan Amount: 10000 
Number of Years: 1 



Annual Interest Rate: 7 


—I Enter 


Monthly Payment: 865.26 
Total Payment: 10383.21 


Payment# 

Interest 

Pri nci pal 

Balance 

1 

58.33 

806.93 

9193.07 

2 

53.62 

811.64 

8381.43 

11 

10.00 

855.26 

860.27 

12 

5.01 

860.25 

0.01 



Note 

The balance after the last payment may not be zero. If so, the last payment should be 
the normal monthly payment plus the final balance. 



Write a loop to display the table. Since the monthly payment is the same for each 
month, it should be computed before the loop. The balance is initially the loan 
amount. For each iteration in the loop, compute the interest and principal and update 
the balance. The loop may look like this: 

for i in range(l, numberOfYears * 12+1): 
interest = monthlyInterestRate * balance 
principal = monthlyPayment - interest 
balance = balance - principal 

print(i, "\t\t", interest, ‘'\t\t", principal, "\t\t", 
balance) 
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*5.25 {Demonstrate cancellation errors) A cancellation error occurs when you are 
manipulating a very large number with a very small number. The large number 
may cancel out the smaller number. For example, the result of 100000000.0 + 
0.000000001 is equal to 100000000.0. To avoid cancellation errors and obtain 
more accurate results, carefully select the order of computation. For example, in 
computing the following series, you will obtain more accurate results by comput¬ 
ing from right to left rather than from left to right: 


Write a program that compares the results of the summation of the preceding 
series, computing both from left to right and from right to left with n = 50000. 


*5.26 (Sum a series) Write a program to sum the following series: 

1 3 5 7 9 11 95 97 

— -f- — -f- — -f — -f- — -f- — -f . . . -f — -f — 

3 5 7 9 11 13 97 99 


**5.27 (Compute tt) You can approximate tt by using the following series: 


77 



1 1 1 (-iy+‘\ 

^ -f ^ ~ — -f... -f-1 

7 9 11 2i - I J 


Write a program that displays the tt value for i = 10000, 20000, . . ., and 

100000 . 


**5.28 (Compute e) You can approximate e by using the following series: 


e = 1 + 


1 1 

— -f — -f 

1! 2! 


1 1 

— + — 

3! 4! 


+ .. . 


+ 


i! 


Write a program that displays the e value for i = 10000, 20000, . . ., and 

1 1 

100000. (Hint: Since i\ = i X (i — 1) X ... X 2 X 1, then — is-. 

i\ i(i — 1)! 

Initialize e and item to be 1 and keep adding a new item to e. The new item is 
the previous item divided by i for i = 2, 3, 4, ... .) 

5.29 (Display leap years) Write a program that displays, ten per line, all the leap years 
in the twenty-first century (from year 2001 to 2100). The years are separated by 
exactly one space. 

**5.30 (Display the first days of each month) Write a program that prompts the user 
to enter the year and first day of the year, and displays the first day of each month 
in the year on the console. For example, if the user entered year 2013, and 2 for 
Tuesday, January 1, 2013, your program should display the following output: 

January 1, 2013 is Tuesday 

December 1, 2013 is Sunday 

**5.3 I (Display calendars) Write a program that prompts the user to enter the year 
and first day of the year, and displays on the console the calendar table for the 
year. For example, if the user entered year 2005, and 6 for Saturday, January 1, 
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2005, your program should display the calendar for each month in the year, as 
follows: 

January 2005 


Sun 

Mon 

Tue 

Wed 

Thu 

Fri 

Sat 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

30 

24 

31 

25 

26 

27 

28 

29 


December 2005 


Sun 

Mon 

Tue 

Wed 

Thu 

Fri 

Sat 





1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

25 

26 

27 

28 

29 

30 

31 


*5.32 {Financial application: compound value) Suppose you save $100 each month into 
a savings account with the annual interest rate 5%. So, the monthly interest rate is 
0.05/12 = 0.00417. After the first month, the value in the account becomes 

100 * (1 + 0.00417) = 100.417 

After the second month, the value in the account becomes 

(100 + 100.417) * (1 + 0.00417) = 201.252 

After the third month, the value in the account becomes 

(100 + 201.252) * (1 + 0.00417) = 302.507 


and so on. 

Write a program that prompts the user to enter an amount (e.g., 100), the annual 
interest rate (e.g., 5), and the number of months (e.g., 6), and displays the amount 
in the savings account after the given month. 

*5.33 {Financial application: compute CD value) Suppose you put $10,000 into a CD 
with an annual percentage yield of 5.75%. After one month, the CD is worth 

10000 + 10000 * 5.75 / 1200 = 10047.91 

After two months, the CD is worth 

10047.91 + 10047.91 * 5.75 / 1200 = 10096.06 
After three months, the CD is worth 

10096.06 + 10096.06 * 5.75 / 1200 = 10145.43 


and so on. 

Write a program that prompts the user to enter an amount (e.g., 10,000), the 
annual percentage yield (e.g., 5.75), and the number of months (e.g., 18), and dis¬ 
plays a table as shown in the sample run. 
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Enter 

the initial deposit amount: 10000 '^Enter 

Enter 

annual percentage yield: 5.75 |^Enter] 

Enter 

maturity period (number of months): 18 LEnter 

Month 

CD Value 

1 

10047.91 

2 

10096.06 

17 

10846.56 

18 

10898.54 



** 5.34 {Game: lottery) Revise Listing 4.10, Lottery.py, to generate a lottery of a two-digit 
number. The two digits in the number are distinct. (Hint; Generate the first digit. 
Use a loop to continuously generate the second digit until it is different from the 
first digit.) 

**5.35 {Perfect number) A positive integer is called a perfect number if it is equal to the 
sum of all of its positive divisors, excluding itself. For example, 6 is the first per¬ 
fect number, because 6 = 3 + 2 -I- 1. The next is 28= \A + l + A + 2+ 1. 
There are four perfect numbers less than 10,000. Write a program to find these 
four numbers. 

***5.36 {Game: scissor, rock, paper) Programming Exercise 4.17 gives a program that 
plays the scissor, rock, paper game. Revise the program to let the user play contin¬ 
uously until either the user or the computer wins more than two times. 

*5.37 {Summation) Write a program that computes the following summation: 


1-f V2 V2 + V3 V3 + Va 

*5.38 {Simulation: clock countdown) You can use the time. si eepCseconds) function 
in the time module to let the program pause for the specified seconds. Write a 
program that prompts the user to enter the number of seconds, displays a message 
at every second, and terminates when the time expires. Here is a sample run: 


Enter the number of seconds: 3 
2 seconds remaining 
1 second remaining 
Stopped 



*5.39 {Financial application: find the sales amount) You have just started a sales job in a 
department store. Your pay consists of a base salary plus a commission. The base 
salary is $5,000. The following scheme shows how to determine the commission rate: 

Sales Amount Commission Rate 

$0.01-$5,000 8 percent 

$5,000.01-$10,000 10 percent 

$10,000.01 and above 12 percent 

Your goal is to earn $30,000 a year. Write a program that finds out the minimum 
amount of sales you have to generate in order to make $30,000. 
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5.40 {Simulation: heads or tails) Write a program that simulates flipping a coin one 
million times and displays the number of heads and tails. 

** 5.41 {Occurrence of max numbers) Write a program that reads integers, finds the 
largest of them, and counts its occurrences. Assume that the input ends with num¬ 
ber 0. Suppose that you entered 3 5 2 5 5 5 0; the program finds that the 
largest number is 5 and the occurrence count for 5 is 4. (Hint: Maintain two vari¬ 
ables, max and count. The variable max stores the current maximum number, and 
count stores its occurrences. Initially, assign the first number to max and 1 to 
count. Compare each subsequent number with max. If the number is greater than 
max, assign it to max and reset count to 1. If the number is equal to max, incre¬ 
ment count by 1.) 


Enter a number (0 

for end of input): 3 |,^Emer| 

Enter a number (0 

for end of input): 5 Enter| 

Enter a number (0 

for end of input): 2 Enter" 

Enter a number (0 

for end of input): 5 paTT] 

Enter a number (0 

for end of input): 5 Enter| 

Enter a number (0 

for end of input): 5 |^Enter| 

Enter a number (0 

for end of input): 0 Enter| 

The largest number is 5 

The occurrence count of the largest number is 4 


**5 .42 {Monte Carlo simulation) A square is divided into four smaller regions as shown in 
(a). If you throw a dart into the square one million times, what is the probability for 
the dart to fall into an odd-numbered region? Write a program to simulate the 
process and display the result. (Hint: Place the center of the square in the center of 
a coordinate system, as shown in (b). Randomly generate a point in the square and 
count the number of times for a point to fall in an odd-numbered region.) 




* 5.43 {Math: combinations) Write a program that displays all possible combinations for 
picking two numbers from integers 1 to 7. Also display the total number of com¬ 
binations. 



1 2 
1 3 

The total number of all combinations is 21 


**5 .44 {Decimal to binary) Write a program that prompts the user to enter a decimal inte¬ 
ger and displays its corresponding binary value. 
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** 5.45 (Decimal to hex) Write a program that prompts the user to enter a decimal integer 
and displays its corresponding hexadecimal value. 

** 5.46 (Statistics: compute mean and standard deviation) In business applications, you 
are often asked to compute the mean and standard deviation of data. The mean is 
simply the average of the numbers. The standard deviation is a statistic that tells 
you how tightly all the various data are clustered around the mean in a set of data. 
For example, what is the average age of the students in a class? How close are the 
ages? If all the students are the same age, the deviation is 0. Write a program that 
prompts the user to enter ten numbers, and displays the mean and standard devia¬ 
tions of these numbers using the following formula: 



Here is a sample run: 


Enter ten numbers: 1 |^1 

2 I —I Enter | 

3 I Enter j 

5 . 5 ll^ I 
5.6 I ^ I 

0 I -I Enter j 

7 I ^ Enter | 

8 I Enter | 

9 I ^ Entei^ 

I —I Enter | 

The mean is 5.61 

The standard deviation is 2.99794 


** 5.47 (Turtle: draw random balls) Write a program that displays 10 random balls in 
a rectangle with width 120 and height 100, centered at (0, 0), as shown in 
Figure 5.3a. 




(a) (b) 

Figure 5.3 The program draws 10 random balls in (a), and 10 circles in (b). 
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** 5.48 (Turtle: draw circles) Write a program that draws 10 circles with centers (0, 0), as 
shown in Figure 5.3h. 

**5 .49 (Turtle: display a multiplication table) Write a program that displays a multiplica¬ 
tion table, as shown in Figure 5.4a. 

**5.50 (Turtle: display numbers in a triangular pattern) Write a program that displays 
numbers in a triangular pattern, as shown in Figure 5.4b. 


Python 

Turtle Graphics . 








Multiplication Table 

12345678 

9 


1 

1 

1 

2 

3 

4 

5 

6 

7 

8 

9 


2 

1 

2 

4 

6 

8 

10 

12 

14 

16 

18 


3 

1 

3 

6 

9 

12 

15 

18 

21 

24 

27 


4 

1 

4 

8 

12 

16 

20 

24 

28 

32 

36 


5 

1 

5 

10 

15 

20 

25 

30 

35 

40 

45 


6 

1 

6 

12 

18 

24 

30 

36 

42 

48 

54 


7 

1 

7 

14 

21 

28 

35 

42 

49 

56 

63 


8 

1 

8 

16 

24 

32 

40 

48 

56 

64 

72 

_ 

9 

^1 

1 

9 

18 

27 

36 

45 

54 

63 

72 

81 

i 

d 

Jj 



Figure 5.4 (a) The program displays a multiplication table, (b) The program displays numbers in a triangular pattern, 

(c) The program displays an 18-by-18 lattice. 


**5.5 I (Turtle: display a lattice) Write a program that displays an 18-by-18 lattice, as 
shown in Figure 5.4c. 

**5.52 (Turtle: plot the sine function) Write a program that plots the sine function, as 
shown in Figure 5.5a. 



The Unicode for tt is \u03c0. To display-Z tt, use turt1e.write("-2\u03c0"). 

For a trigonometric function like sin(x), x is in radians. Use the following loop to plot 
the sine function: 

for X in range(-175, 176): 

turtle.goto(x, 50 * math.sin((x / 100) * 2 * math.pi)) 

-277 is displayed at (-100, -15), the center of the axis is at (0, 0), and 277 is 
displayed at (100, -15). 
























































































Programming Exercises 169 



Figure 5.5 (a) The program plots a sine function, (b) The program plots sine function in blue and cosine function in red. 


**5.53 {Turtle: plot the sine and cosine functions) Write a program that plots the sine 
function in red and cosine in blue, as shown in Figure 5.5b. 

** 5.54 {Turtle: plot the square function) Write a program that draws a diagram for the 
function/(x) = (see Figure 5.6a). 



(a) 


(b) 


Figure 5.6 (a) The program plots a diagram for function/(x) = x^. (b) The program draws a chessboard. 


**5.55 {Turtle: chessboard) Write a program to draw a chessboard, as shown in 
Figure 5.6b. 
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CHAPTER 


6 

Functions 

objectives 

■ To define functions with formal parameters (§6.2). 

■ To invoke functions with actual parameters (i.e., arguments) (§6.3). 

■ To distinguish between functions that return and do not return a 
value (§6.4). 

■ To invoke a function using positional arguments or keyword 
arguments (§6.5). 

■ To pass arguments by passing their reference values (§6.6). 

■ To develop reusable code that is modular and is easy to read, debug, 
and maintain (§6.7). 

■ To create modules for reusing functions (§§6.7-6.8). 

■ To determine the scope of variables (§6.9). 

■ To define functions with default arguments (§6.10). 

■ To define a function that returns multiple values (§6.11). 

■ To apply the concept of function abstraction in software 
development (§6.12). 

■ To design and implement functions using stepwise refinement (§6.13). 

■ To simplify drawing programs with reusable functions (§6.14). 
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problem 


6.1 Introduction 


»r ) Point 


Functions can be used to define reusable code and organize and simplify code. 

Suppose that you need to find the sum of integers from 1 to 10, 20 to 37, and 35 to 49. If you 
create a program to add these three sets of numbers, your code might look like this: 


sum = 0 

for i in rangefl, 11 ): 
sum += i 

printC'Sum from 1 to 10 is", sum) 


why functions? 


define sum function 


define mat n function 
invoke sum 


functions 


sum = 0 

for i in range(20, 38): 
sum += i 

printC'Sum from 20 to 37 is", sum) 

sum = 0 

for i in range(35, 50): 
sum += i 

printC'Sum from 35 to 49 is", sum) 

You may have observed that the code for computing these sums is very similar, except that 
the starting and ending integers are different. Wouldn’t it be nice to be able to write com¬ 
monly used code once and then reuse it? You can do this by defining a function, which 
enables you to create reusable code. For example, the preceding code can be simplified by 
using functions, as follows: 

1 def sum(i 1, i2): 

2 result = 0 

3 for i in range(il, i2 + 1): 

4 result += i 

5 

6 return result 

7 

8 def mai n () : 

9 printC'Sum from 1 to 10 is", sum(l, 10)) 

10 printC'Sum from 20 to 37 is", sum(20, 37)) 

11 printC'Sum from 35 to 49 is", sum(35, 49)) 

12 

13 mainO # Call the main function 

Lines 1-6 define the function named sum with the two parameters il and i2. Lines 8-11 
define the mai n function that invokes sum(l, 10) to compute the sum from 1 to 10, sum(20, 
37) to compute the sum from 20 to 37, and sum(3 5 , 49) to compute the sum from 35 to 49. 

A function is a collection of statements grouped together that performs an operation. In 
earlier chapters, you learned about such functions as eval ("numericString") and 
random.randint(a, b). When you call the random.randint(a, b) function, for 
example, the system actually executes the statements in the function and returns the result. In 
this chapter, you will learn how to define and use functions and apply function abstraction to 
solve complex problems. 




Key 

Point 


6.2 Defining a Function 

A function definition consists of the function’s name, parameters, and body. 
The syntax for defining a function is as follows: 


VideoNote 

Use functions 


def functionNamefliSt of parameters) 
# Function body 
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Let’s look at a function created to find which of two numbers is bigger. This function, 
named max, has two parameters, numl and num2, the larger of which is returned by the func¬ 
tion. Figure 6.1 illustrates the components of this function. 


Invoke a function 


Figure 6.1 You can define a function and invoke it with arguments. 


z = max(x, y) 

t t 

actual parameters 
(arguments) 


Define a function 


function name formal 

1 parameters 

|def maxCnuml, num2):| 

function ^ 

if numl > num2: 

result = numl 

e1 se: 

result = num2 

return result 

return value 

body 


A function contains a header and body. The header begins with the def keyword, followed 
by the function’s name and parameters, and ends with a colon. 

The variables in the function header are known as formal parameters or simply parameters. 
A parameter is like a placeholder: When a function is invoked, you pass a value to the para¬ 
meter. This value is referred to as an actual parameter or argument. Parameters are optional; 
that is, a function may not have any parameters. For example, the random. randomO function 
has no parameters. 

Some functions return a value, while other functions perform desired operations without 
returning a value. If a function returns a value, it is called a value-returning function. 

The function body contains a collection of statements that define what the function does. 
For example, the function body of the max function uses an i f statement to determine which 
number is larger and return the value of that number. A return statement using the keyword 
return is required for a value-returning function to return a result. The function terminates 
when a return statement is executed. 

6.3 Calling a Function 

Calling a function executes the code in the function. 

In a function’s definition, you define what it is to do. To use a function, you have to call or 
invoke it. The program that calls the function is called a caller. There are two ways to call a 
function, depending on whether or not it returns a value. 

If the function returns a value, a call to that function is usually treated as a value. For 
example, 

larger = max(3, 4) 

calls maxC3 , 4) and assigns the result of the function to the variable I arger. 

Another example of a call that is treated as a value is 

print(max(3, 4)) 


function header 

formal parameters 
parameters 
actual parameter 
argument 

value-returning function 


tr/Key 
vT- J Point 

caller 


which prints the return value of the function call max (3 , 4). 


return value 








174 Chapter 6 Functions 


define max function 


man n function 


invoke max 


man n function 


execution 


If a function does not return a value, the call to the function must he a statement. For example, 
the pri nt function does not return a value. The following call is a statement: 

pri ntC'Programming is fun!") 


Note 

A value-returning function also can be invoked as a statement. In this case, the return value 
is ignored. This is rare but is permissible if the caller is not interested in the return value. 

When a program calls a function, program control is transferred to the called function. A 
called function returns control to the caller when its return statement is executed or the func¬ 
tion is finished. 

Listing 6.1 shows a complete program that is used to test the max function. 

Listing 6.1 TestMax.py 

1 # Return the max of two numbers 

2 def max(numl, num2): 

3 if numl > num2: 

4 result = numl 

5 else: 

6 result = num2 

7 

8 return result 

9 

10 def mainO : 

11 i = 5 

12 j = 2 

13 k = max(i, j) # Call the max function 

14 printC'The larger number of", i, "and", j, "is", k) 

15 

16 mainO # Call the main function 




The larger number of 5 and 2 is 5 





This program contains the max and mai n functions. The program script invokes the mai n 
function in line 16. By convention, programs often define a function named main that con¬ 
tains the main functionality for a program. 

How is this program executed? The interpreter reads the script in the file line by line starting 
from line 1. Since line 1 is a comment, it is ignored. When it reads the function header in line 2, 
it stores the function with its body (lines 2-8) in the memory. Remember that a function’s defini¬ 
tion defines the function, but it does not cause the function to execute. The interpreter then reads 
the definition of the mai n function (lines 10-14) to the memory. Finally, the interpreter reads the 
statement in line 16, which invokes the main function and causes the main function to be 
executed. The control is now transferred to the mai n function, as shown in Figure 6.2. 
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pass int 5 



Figure 6.2 When a function is invoked, the control is transferred to the function. When the 
function is finished, the control is returned to where the function was called. 

The execution of the main function begins in line 11. It assigns 5 to i and 2 to j (lines 
11-12) and then invokes maxCi , j) (line 13). 

When the max function is invoked (line 13), variable i ’s value is passed to numl and vari- max function 
able j’s value is passed to num2. The control is transferred to the max function, and the max 
function is executed. When the return statement in the max function is executed, the max 
function returns the control to its caller (in this case the caller is the mai n function). 

After the max function is finished, the returned value from the max function is assigned to 
k (line 13). The main function prints the result (line 14). The main function is now finished, 
and it returns the control to its caller (line 16). The program is now finished. 

Note 

Here main is defined after max. In Python, functions can be defined in any order in a order of functions 

script file as long as the function is in the memory when it is called. You can also define 
main before max. 



6.3.1 Callstacks 

Each time a function is invoked, the system creates an activation record that stores its argu- activation record 

ments and variables for the function and places the activation record in an area of memory 

known as a call stack. A call stack is also known as an execution stack, runtime stack, or 

machine stack, and is often shortened to just “the stack.” When a function calls another stack 

function, the caller’s activation record is kept intact and a new activation record is created for 

the new function call. When a function finishes its work and returns control to its caller, its 

activation record is removed from the call stack. 

A call stack stores the activation records in a last-in, first-out fashion. The activation record 
for the function that is invoked last is removed first from the stack. Suppose function ml calls 
function m2, and then m3. The runtime system pushes ml’s activation record into the stack, 
then m2’s, and then m3’s. After m3 is finished, its activation record is removed from the stack. 

After m2 is finished, its activation record is removed from the stack. After ml is finished, its 
activation record is removed from the stack. 

Understanding call stacks helps us comprehend how functions are invoked. When the 
main function is invoked, an activation record is created to store variables and j, as shown 
in Figure 6.3a. Remember that all data in Python are objects. Python creates and stores 
objects in a separate memory space called heap. Variables i and j actually contain reference heap 
values to int objects 5 and 2, as shown in Figure 6.3a. 

Invoking max(i , j) passes the values i and j to parameters numl and num2 in the max 
function. So now numl and num2 reference int objects 5 and 2, as shown in Figure 6.3b. The 
max function finds the maximum number and assigns it to resul t, so resul t now 
references int object 5, as shown in Figure 6.3c. The result is returned to the main function 
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stack 


Space required for 
the mai n function 

j: - 


(a) The mai n function 
is invoked. 


stack 


Space required for 
the mai n function 

k: - 
j: 2- 
i : 5 - 


(d) The max function 
is finished and the 
return value is sent 
to k. 


vT' / Point 


void function 


stack 


stack 




Space required for 
the max function 


num2: 

numl: 


Space required for 


the main function 


j: 


i : 


This is the heap 
for storing 
objects. 


(b) The max function 
is invoked. 


This is the heap (c) The max function 
for storing is being executed, 

objects. 



This is the heap 
for storing 
objects. 


stack 


Stack is 
now empty 


(e) The mai n 
function is finished. 


Figure 6.3 When a function is invoked, an 
activation record is created to store variables in 
the function. The activation record is released 
after the function is finished. 


and assigned to variable k. Now k references i nt object 5, as shown in Figure 6.3d. After the 
mai n function is finished, the stack is empty, as shown in Figure 6.3e. The objects in the heap 
are automatically destroyed by the Python interpreter when they are no longer needed. 

6.4 Functions with/without Return Values 

A function does not have to return a value. 

The preceding section gives an example of a value-returning function. This section shows 
how to define and invoke a function that does not return a value. Such a function is commonly 
known as a void function in programming terminology. 

The program in Listing 6.2 defines a function named printGrade and invokes it to print 
the grade for a given score. 

Listing 6.2 Pri ntCradeFuncti on. py 

1 # Print grade for the score 

2 def printGrade(score): 

3 if score >= 90.0: 

4 print('A') 

5 elif score >= 80.0: 

6 print('B') 

7 elif score >= 70.0: 

8 print('C') 


pri ntCrade function 
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9 elif score >= 60.0: 

10 pr-int('D') 

11 else: 

12 pr-int('F') 

13 

14 def mainO : main function 

15 score = eval(i nput("Enter a score; )) 

16 printC'The grade is ", end = " ) 

17 printGrade(score) invoke pri ntCrade 

18 

19 mainO # Call the main function 


Enter a score: 78.5 |^| 
The grade is C 


The printCrade function does not return any value. So, it is invoked as a statement in 
line 17 in the main function. 

To see the differences between a function that does not return a value and a function that 
returns a value, let’s redesign the printCrade function to return a value. We call the new 
function that returns the grade, getCrade, as shown in Listing 6.3. 


Listing 6.3 ReturnGradeFunction.py 


1 

# Return the grade for the score 


2 

def getGrade(score): 

getCrade function 

3 

if score >= 90.0: 


4 

return 'A' 


5 

elif score >= 80.0: 


6 

return B' 


7 

elif score >= 70.0: 


8 

return 'C 


9 

elif score >= 60.0: 


10 

return 'D' 


11 

el se: 


12 

return 'F' 


13 

14 

def mainO : 

mai n function 

15 

score = eval(i nputC'Enter a score: ")) 


16 

printC'The grade is", getGrade(score)) 

invoke getCrade 

17 

18 

mainO # Call the main function 



Enter a score: 78.5 |^Enter| 
The grade is C 



The getCrade function defined in lines 2-12 returns a character grade based on the 
numeric score value. It is invoked in line 16. 

The getCrade function returns a character, and it can be invoked and used just like a 
character. The printCrade function does not return a value, and it must be invoked as a 
statement. 
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Technically, every function in Python returns a value whether you use return or not. If 
a function does not return a value, by default, it returns a special value None. For this 
reason, a function that does not return a value is also called a None function. The None 
value can be assigned to a variable to indicate that the variable does not reference any 
object. For example, if you run the following program: 

def sum(numberl, numberZ): 

total = numberl + number2 

prl nt(sum(l , 2)) 

you will see the output is None, because the sum function does not have a return state¬ 
ment. By default, it returns None. 


Note 

A return statement is not needed for a None function, but it can be used for ter¬ 
minating the function and returning control to the function's caller. The syntax is 
simply 

return 

or 

return None 

This is rarely used, but it is sometimes useful for circumventing the normal flow of con¬ 
trol in a function that does not return any value. For example, the following code has a 
return statement to terminate the function when the score is invalid. 

# Print grade for the score 
def printGrade(score): 

if score < 0 or score > 100: 
pri ntC'Inval id score' ) 
return # Same as return None 

if score >= 90.0: 

print('A') 
el if score >= 80.0: 

print('B') 
elif score >= 70.0: 

print('C') 
elif score >= 60.0: 

print('D') 
else: 

print('F') 

6.1 What are the benefits of using a function? 

6.2 How do you define a function? How do you invoke a function? 

6.3 Can you simplify the max function in Listing 6.1 hy using a conditional 
expression? 

6.4 True or false? A call to a None function is always a statement itself, but a call to a 
value-returning function is always a component of an expression. 

6.5 Can you have a return statement in a None function? Does the return statement in 
the following function cause syntax errors? 

def xFunction(x, y) : 
print(x + y) 

return 
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6.6 Define the terms function header, parameter, and argument. 

6.7 Write function headers for the following functions (and indicate whether the function 
returns a value): 

■ Computing a sales commission, given the sales amount and the commission rate. 

■ Printing the calendar for a month, given the month and year. 

■ Computing a square root. 

■ Testing whether a number is even, and returning true if it is. 

■ Printing a message a specified number of times. 

■ Computing the monthly payment, given the loan amount, number of years, and 
annual interest rate. 

■ Finding the corresponding uppercase letter, given a lowercase letter. 

6.8 Identify and correct the errors in the following program: 

1 def functionl(n, m): 

2 function2(3 .4) 

3 

4 def function2(n): 

5 if n > 0: 

6 return 1 

7 el i f n == 0 : 

8 return 0 

9 el i f n < 0 : 

10 return -1 

11 

12 functionl(2, 3) 

6.9 Show the output of the following code: 

1 def man n() : 

2 print(min(5, 6)) 

3 

4 def min(nl, n2): 

5 smallest = nl 

6 if n2 < smallest: 

7 smallest = n2 

8 

9 mainO # Call the main function 

6 .10 What error will occur when you run the following code? 
def mai n() : 

print(min(mi n(5 , 6), (51, 6))) 

def min(nl, n2): 
smallest = nl 
if n2 < smallest: 
smallest = n2 

mainO # Call the main function 

6.5 Positional and Keyword Arguments 

A function’s arguments can be passed as positional arguments or keyword arguments. 

The power of a function is its ability to work with parameters. When calling a function, you 
need to pass arguments to parameters. There are two kinds of arguments: positional arguments 
and keyword arguments. Using positional arguments requires that the arguments be passed in 
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pass-by-value 


the same order as their respective parameters in the function header. For example, the follow¬ 
ing function prints a message n times: 

def nPrintlnfmessage, n) : 
for 1 in range(n): 
print(message) 

You can use nPrintlnC'a' , 3) to print a three times. The nPrintlnC'a' , 3) 

statement passes a to message, passes 3 to n, and prints a three times. However, the state¬ 
ment nPrintln(3, 'a') has a different meaning. It passes 3 to message and a to n. 
When we call a function like this, it is said to use positional arguments. The arguments 
must match the parameters in order, number, and compatible type, as defined in the func¬ 
tion header. 

You can also call a function using keyword arguments, passing each argument in the 
form name = va/we. For example, nPrintln(n = 5, message "good") passes 5 
to n and "good" to message. The arguments can appear in any order using keyword 
arguments. 

It is possible to mix positional arguments with keyword arguments, but the positional argu¬ 
ments cannot appear after any keyword arguments. Suppose a function header is 

def f(pl, p2, p3): 

You can invoke it by using 


f(30, p2 = 4, p3 = 10) 


However, it would be wrong to invoke it by using 
f(30, p2 = 4, 10) 

because the positional argument 10 appears after the keyword argument p2 = 4. 

6 .1 I Compare positional arguments and keyword arguments. 

6.12 Suppose a function header is as follows: 
def f(pl, p2, p3, p4): 

Which of the following calls are correct? 

f(l, p2 = 3, p3 = 4, p4 = 4) 

f(l, p2 = 3, 4, p4 = 4) 

f(pl = 1, p2 = 3, 4, p4 = 4) 

f(pl = 1, p2 = 3, p3 = 4, p4 = 4) 

f(p4 = 1, p2 = 3, p3 = 4, pi = 4) 

6.6 Passing Arguments by Reference Values 

When you invoke a function with arguments, each argument's reference is passed by 
value to the parameter in the function. 

Because all data are objects in Python, a variable for an object is actually a reference to the 
object. When you invoke a function with arguments, the reference value of each argument is 
passed to the parameter. This is referred to as pass-by-value in programming terminology. For 
simplicity, we say that the value of an argument is passed to a parameter when invoking a 
function. The value is actually a reference value to the object. 
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If the argument is a number or a string, the argument is not affected, regardless of the 
changes made to the parameter inside the function. Listing 6.4 gives an example. 

Listing 6.4 Increment.py 

1 def mat n () : 

2 X = 1 

3 pri ntC'Before the call, x is", x) 

4 i ncrement(x) invoke increment 

5 printC'After the call, x is", x) 

6 

7 def increment(n): 

8 n += 1 increment n 

9 print("\tn inside the function is", n) 

10 

11 mainO # Call the main function 


Before the call, x is 1 

n inside the function is 2 
After the call, x is 1 



As shown in the output for Listing 6.4, the value of x (1) is passed to the parameter n to 
invoke the i ncrement function (line 4). The parameter n is incremented by 1 in the function 
(line 8), but x is not changed no matter what the function does. 

The reason is that numbers and strings are known as immutable objects. The contents of immutable objects 
immutable objects cannot be changed. Whenever you assign a new number to a variable. 

Python creates a new object for the new number and assigns the reference of the new object to 
the variable. 

Consider the following code: 


»> X = 4 
»> y = X 

»> id(x) # The reference of x 
505408920 

»> id(y) # The reference of y is the same as the reference of x 
505408920 
»> 



You assign x to y, and both x and y now point to the same object for integer value 4, as 
shown in Figure 6.4a-b. But if you add 1 to y, a new object is created and assigned to y, as 
shown in Figure 6.4c. Now y refers to a new object, as shown in the following code: 


»> y = y + 1 # y now points to a new int object with value 5 
»> id(y) 

505408936 

»> 









182 Chapter 6 Functions 


x = 4 

y = x 

II 

+ 

id:505408920 

id:505408920 

id:505408920 

^-►The object 

for int 4 

^—^The object 
y' for int 4 

^-►The object 

for int 4 


y' 

id:505408936 



y -►The object! 

for int 5 | 

(a) 

(b) 

(c) 


Figure 6.4 (a) 4 is assigned to x; (b) x is assigned to y; (c) y + 1 is assigned to y. 
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6.13 What is pass-by-value? 

6.14 Can the argument have the same name as its parameter? 

6.15 Show the result of the following programs: 


def main(): 


def main(): 

max = 0 


i = 1 

getMax(l, 2, max) 


while i <= 6: 

print(max) 


printffunctionl(i, 2)) 



i += 1 

def getMaxfvaluel, valueZ, max): 



if valuel > value2: 


def functionlfi, num): 

max = valuel 


line = 

else: 


for j in rangefl, i): 

max = value2 


line -H= str(num) + " " 



num *= 2 

main() 


return line 



mai n() 


(a) (b) 


def main(): 


def main(): 

# Initialize times 


i = 0 

times = 3 


while i <= 4: 

pri ntC'Before the call, variable", 


functionl(i) 

"times is", times) 


i += 1 

# Invoke nPrintln and display times 


printC'i is", i) 

nPri ntC'Welcome to CS!", times) 



printC'After the call, variable". 


def functionl(i): 

'times is", times) 


line = " " 



while i >= 1: 

# Print the message n times 


if i % 3 != 0: 

def nPrintfmessage, n): 


line += str(i) + 

while n > 0: 


i -= 1 

printC'n , n) 



print(message) 


pri nt(l i ne) 

n -= 1 





mai n() 

mai n () 




(c) (d) 
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6 . 16 For (a) in the preceding question, show the contents of the stack just before the func¬ 
tion max is invoked, just as max is entered, just before max is returned, and right after 
max is returned. 


6.7 Modularizing Code 

Modularizing makes code easy to maintain and debug, and enables the code to be 
reused. 

^/Key 
^ 1 Point 

Functions can be used to reduce redundant code and enable code reuse. Functions can also 
be used to modularize code and improve a program’s quality. In Python, you can place the 
function definition into a file called module with the file-name extension . py. The module 
can be later imported into a program for reuse. The module file should be placed in the 
same directory with your other programs. A module can contain more than one function. 
Each function in a module must have a different name. Note that the turtl e, random, and 
math are the modules defined in the Python library, and thus they can be imported into any 
Python program. 

Listing 5.8, CreatestCommonDi vi sor. py, shows a program that prompts the user to 
enter two integers and displays their greatest common divisor. You can rewrite the pro¬ 
gram to use a function and place it into a module named CCDFunction. py, as shown in 
Listing 6.5. 

module 

Listing 6.5 GCDFunction.py 

1 # Return the gcd of two integers 

2 def gcd(nl, n2) : 

3 gcd = 1 # Initial gcd is 1 

4 k = 2 # Possible gcd 

5 

6 while k <= nl and k <= n2: 

7 if nl % k == 0 and n2 % k == 0: 

8 gcd = k # Update gcd 

9 k += 1 

10 

11 return gcd # Return gcd 

define gcd function 

return gcd 


Now we write a separate program to use the gcd function, as shown in Listing 6.6. 


Listing 6.6 TestGCDFuncti on. py 

1 from CCDFunction import gcd # Import the gcd function 

2 

3 # Prompt the user to enter two integers 

4 nl = eval(i nputC'Enter the first integer: ")) 

5 n2 = eval(i nputC'Enter the second integer: ")) 

6 

7 printC'The greatest common divisor for", nl, 

8 "and", n2, "is", gcd(nl, n2)) 

import gcd 

get input 

invoke gcd 

Enter the first integer: 45 1^ Enter] 

Enter the second integer: 75 

The greatest common divisor for 45 and 75 is 15 

ill 
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Line 1 imports the gcd function from the GCDFunction module, which enables you to 
invoke gcd in this program (line 8). You can also import it using the following statement: 

import GCDFunction 

Using this statement, you would have to invoke gcd using GCDFunction. gcd. 

By encapsulating the code for obtaining the gcd in a function, this program has several 
advantages: 

1. It isolates the problem for computing the gcd from the rest of the code in the program. 
Thus, the logic becomes clear and the program is easier to read. 

2. Any errors for computing the gcd are confined to the gcd function, which narrows the 
scope of debugging. 

3. The gcd function now can be reused by other programs. 

What happens if you define two functions with the same name in a module? There is no 
syntax error in this case, but the latter function definition prevails. 

Listing 6.7 applies the concept of code modularization to improve Listing 5.13, 
PrimeNumber .py. The program defines two new functions, isPrime and 
printPrimeNumbers. The isPrime function determines whether a number is prime, and 
the printPrimeNumbers function prints prime numbers. 


Listing 6.7 PrimeNumberFunction.py 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 


# Check whether number is prime 
def isP rime(number): 
divisor = 2 

while divisor <= number / 2: 
if number % divisor == 0: 

# If true, number is not prime 
return False # number is not a prime 
divisor += 1 

return True # number is prime 

def printPrimeNumbers(numberOfPrimes): 

NUMBER_0F_PRIMES = 50 # Number of primes to display 

NUMBER_0F_PRIMES_PER_LINE = 10 # Display 10 per line 

count =0 # Count the number of prime numbers 

number =2 # A number to be tested for primeness 

# Repeatedly find prime numbers 
while count < numberOfPrimes: 

# Print the prime number and increase the count 
if isPrime(number): 

count += 1 # Increase the count 

print(number, end = ") 

if count % NUMBER_0F_PRIMES_PER_LINE == 0: 

# Print the number and advance to the new line 
pri nt() 

# Check if the next number is prime 
number += 1 

def mai n () : 

printC'The first 50 prime numbers are") 
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34 printPrimeNumbers(50) invoke printPrimeNumbers 

35 

36 mainO # Call the main function 


The 

fi rst 

50 

3ri me 

numbers are 




2 

3 

5 

7 

11 

13 

17 

19 

23 

29 

31 

37 

41 

43 

47 

53 

59 

61 

67 

71 

73 

79 

83 

89 

97 

101 

103 

107 

109 

113 

127 

131 

137 

139 

149 

151 

157 

163 

167 

173 

179 

181 

191 

193 

197 

199 

211 

223 

227 

229 



This program divides a large problem into two subproblems. As a result, the new program 
is easier to read and easier to debug. Moreover, the functions pri ntPrimeNumbers and 
i sPrime can be reused by other programs. 


6.8 Case Study: Converting Decimals to Hexadecimals 

This section presents a program that converts a decimal number to a hexadecimal 
number. 
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Hexadecimal numbers (introduced in Chapter 3) are often used in computer systems pro¬ 
gramming (see Appendix C for information on number systems). To convert a decimal 
number to a hexadecimal number, you have to find the hexadecimal digits 
K-u hn- 2 , ■ ■ ■, ^ 2 , hy, and ho such that 


d = h„X 16" + /i„_i X 16"^' + /i„_2 X 16"^^ + . . . 
+ /i2 X 16^ + hiX 16^ + hoX 16° 


These hexadecimal digits can be found by successively dividing r/ by 16 until the quotient 
is 0. The remainders are /iq, hy,h 2 , ... , /i„- 2 , h„^i, and /i„. The hexadecimal digits include 
the decimal digits 0,1,2,3,4,5,6,7,8,9 plus A which is the decimal value 10, B which is the 
decimal value 11, C which is 12, D which is 13, E which is 14, and F which is 15. 

For example, the decimal number 123 is 7B in hexadecimal. The conversion is done as 
shown below; 



Quotient 


Remainder 


I 

hi 


\ 

ho 


The remainder of dividing 123 by 16 is 11, which is B in hexadecimal. The quotient of this 
division is 7. The remainder of dividing 7 by 16 is 7 and the quotient is 0. So, 7B is the hexa¬ 
decimal number for 123. 

The program in Listing 6.8 prompts the user to enter a decimal number and converts it into 
a hex number as a string. 


Listing 6.8 Decimal ZHexConversion. py 

1 # Convert a decimal to a hex as a string 

2 def decimaiToHex(decimaiVaiue): 


define deci mal ToHex 
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define toHexChar 


get a letter 


input decimal 


3 hex = 

4 

5 while decimal Value != 0: 

6 hexValue = decimal Value % 16 

7 hex = toHexChar(hexValue) + hex 

8 decimalValue = decimalValue // 16 

9 

10 return hex 

11 

12 # Convert an integer to a single hex digit as a character 

13 def toHexChar(hexValue): 

14 if 0 <= hexValue <= 9: 

15 return chr(hexValue + ord(’0‘)) 

16 else: # 10 <= hexValue <= 15 

17 return chr(hexValue - 10 + ord( ,. )) 

18 

19 def mainO: 

20 # Prompt the user to enter a decimal integer 

21 decimalValue = eval(i nput("Enter a decimal number: ")) 

22 

23 printC'The hex number for decimal", 

24 decimalValue, "is", decimalToHex(decimalValue)) 

25 

26 mainO # Call the main function 



Enter a decimal number: 1234 ’^EnteT] 

The hex number for decimal 1234 is 4D2 




line# 

decimalValue hex 

hexValue 

toHexChar(hexValue) 

21 

1234 



3 

tl 



r ® 


2 


iteration 1 ■< 7 

"2" 


"2" 

1 8 

77 



r ® 


13 


iteration 2 7 

"D2" 


"D" 

L 8 

4 



r ® 


4 


iteration 3 7 

"4D2" 


"4" 

^ 8 

0 




The hex string is initially empty (line 3). The program uses the decimalToHex function 
(lines 2-10) to convert a decimal integer to a hex number as a string. The function gets the 
remainder of the division of the decimal integer by 16 (line 6). The remainder is converted into 
a character by invoking the toHexChar function and then appending to the hex string (line 7). 
Dividing the decimal number by 16 removes a hex digit from the number (line 8). The function 
repeatedly performs these operations in a loop until the quotient becomes 0 (lines 5-8). 

The toHexChar function (lines 13-17) converts a hexValue between 0 and 15 into a hex 
character. If hexVal ue is between 0 and 9, it is converted to chr ChexVal ue + ordC' 0') ) 
(line 15). For example, if hexVal ue is 5, chr (hexVal ue + ordC ' 0 ')) returns 5. Similarly, if 
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hexValue is between 10 and 15, it is converted to chrChexValue - 10 + ordC'A')) (line 
17). Forexample, if hexValue is 11, chrChexValue - 10 + ord('A')) returns B. 

6.9 The Scope of Variables 

The scope of a variable is the part of the program where the variable can be referenced. 

Chapter 2 introduced the scope of variables. This section discusses the scope of variables in 
the context of functions. A variable created inside a function is referred to as a local variable. 
Local variables can only be accessed within a function. The scope of a local variable starts 
from its creation and continues to the end of the function that contains the variable. 

In Python, you can also use global variables. They are created outside all functions and are 
accessible to all functions in their scope. Consider the following examples. 

Example I 

1 globalVar = 1 

2 def fl(): 

3 localVar = 2 

4 print(globalVar) 

5 print(localVar) 

6 

7 flQ 

8 print(globalVar) 

9 print(localVar) # Out of scope, so this gives an error 

A global variable is created in line 1. It is accessed within the function in line 4 and outside the 
function in line 8. A local variable is created in line 3. It is accessed within the function in line 5. 
Attempting to access the variable from outside of the function causes an error in line 9. 

Example 2 

1 X = 1 

2 def fl(): 

3 X = 2 

4 print(x) # Displays 2 

5 

6 flQ 

7 print(x) # Displays 1 

Here a global variable x is created in line 1 and a local variable with the same name (x) is 
created in line 3. From this point on, the global variable x is not accessible in the function. 
Outside the function, the global variable x is still accessible. So, it prints 1 in line 7. 

Example 3 

1 X = eval(i nputC'Enter a number: ")) 

2 if X > 0: 

3 y = 4 

4 

5 print(y) # This gives an error if y is not created 

Here the variable y is created if x > 0. If you enter a positive value for x (line 1), the program 
rans fine. But if you enter a nonpositive value, line 5 produces an error because y is not created. 

Example 4 

1 sum = 0 

2 for i in range(5): 
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3 sum += 1 

4 

5 print(i) 

Here the variable i is created in the loop. After the loop is finished, i is 4, so line 5 
displays 4. 

You can bind a local variable in the global scope. You can also create a variable in a func¬ 
tion and use it outside the function. To do either, use a gl obal statement, as shown in the 
following example. 

Example 5 

1 X = 1 

2 def i ncreaseO: 

3 g1 oba1 x 

4 X = X + 1 

5 print(x) # Displays 2 

6 

7 increaseO 

8 print(x) # Displays 2 

Here a global variable x is created in line 1 and x is bound in the function in line 3, which 
means that x in the function is the same as x outside of the function, so the program prints 2 
in line 5 and in line 8. 

Caution 

Although global variables are allowed and you may see global variables used in other 
programs, it is not a good practice to allow them to be modified in a function, because 
doing so can make programs prone to errors. However, it is fine to define global con¬ 
stants so all functions in the module can share them. 

6.17 What is the printout of the following code? 


def function(x): 


def f(x, y = 1 , z = 2) : 

print(x) 

X = 4.5 


return x -i- y -i- z 

y = 3.4 


print(f(l, 1, 1)) 

print(y) 


print(f(y = 1, x = 2, z = 3)) 
print(f(l, z = 3)) 

X = 2 



y = 4 

function(x) 
print(x) 
print(y) 




(a) (b) 


6 . 18 What is wrong in the following code? 

1 def functionO: 

2 X = 4.5 

3 y = 3.4 

4 print(x) 

5 print(y) 

6 
7 


functionO 




8 print(x) 

9 printCy) 
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6.19 Can the following code ran? If so, what is the printout? 

X = 10 
if X < 0: 

y = -1 
e1 se; 

y = 1 

printC'y is", y) 

6.10 Default Arguments 

Python allows you to define functions with default argument values. The default values 
are passed to the parameters when a function is invoked without the arguments. 

Listing 6.9 demonstrates how to define functions with default argument values and how to 
invoke such functions. 

Listing 6.9 Defaul tArgumentDemo. py 

1 def printAreafwidth = 1, height =2): 

2 area = width * height 

3 pri ntC'widthL , width, '\theight:", height, "\tarea:", area) 

4 

5 printAreaO # Default arguments width = 1 and height = 2 

6 printArea(4, 2.5) # Positional arguments width = 4 and height = 2.5 

7 printAreafheight = 5, width = 3) # Keyword arguments width 

8 printAreafwidth =1.2) # Default height = 2 

9 printAreafheight = 6.2) # Default width = 1 


width: 

1 

height: 

2 

area: 2 

wi dth: 

4 

height: 

2.5 

area: 10.0 

width: 

3 

height: 

5 

area: 15 

wi dth: 

1.2 

height: 

2 

area: 2.4 

width: 

1 

height: 

6.2 

area: 6.2 


Line 1 defines the printArea function with the parameters width and height, width 
has the default value 1 and height has the default value 2. Line 5 invokes the function with¬ 
out passing an argument, so the program uses the default value 1 assigned to width and 2 to 
height. Line 6 invokes the function hy passing 4 to width and 2.5 to height. Line 7 
invokes the function by passing 3 to width and 5 to height. Note that you can also pass the 
argument by specifying the parameter name, as shown in lines 8 and 9. 



Note 

A function may mix parameters with default arguments and non-default arguments. In 
this case, the non-default parameters must be defined before default parameters. 



Note 

Many programming languages support a useful feature that allows you to define two 
functions with the same name in a module, but it is not supported in Python. With 
default arguments, you can define a function once, and call the function in many 


tr/Key 

r; Point 

default argument 


default argument 


default arguments 
positional arguments 
keyword arguments 
mixed arguments 
mixed arguments 
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different ways. This achieves the same effect as defining multiple functions with the 
same name in other programming languages. If you define multiple functions in Python, 
the later definition replaces the previous definitions. 

6.20 Show the printout of the following code: 

def f (w = 1 , h = 2) : 
printCw, h) 

fO 

f(w = 5) 
f(h = 24) 
f(4, 5) 

6.21 Identify and correct the errors in the following program: 

1 def man n() : 

2 nPrintlnCS) 

3 

4 def nPrintln(message = 'Welcome to Python!", n) : 

5 for 1 in range(n): 

6 print(message) 

7 

8 mainO # Call the main function 

6.22 What happens if you define two functions in a module that have the same name? 

^/Key 

C' / Point 

6.11 Returning Multiple Values 

The Python return statement can return multiple values. 

Python allows a function to return multiple values. Listing 6.10 defines a function that takes 
two numbers and returns them in ascending order. 

return multiple values 

Listing 6.10 Multi pi eReturnValueDemo.py 

1 def sort(numberl, number2) : 

2 if numberl < number2: 

3 return numberl, number2 

4 else: 

5 return number2, numberl 

6 

receiving returned values 

7 nl, n2 = sortfS, 2) 

8 printC'nl is", nl) 

9 print("n2 is", n2) 


nl is 2 
n2 is 3 

ii^eck 
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MyProgrammingLab" 

The sort function returns two values. When it is invoked, you need to pass the returned 
values in a simultaneous assignment. 

6.23 Can a function return multiple values? Show the printout of the following code: 

1 def f(x , y) : 

2 return x+y, x-y, x*y, x/y 

3 

4 tl, t2, t3, t4 = f(9, 5) 

5 printftl, t2, t3, t4) 
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6.12 Case Study: Generating Random ASCII Characters 

A character is coded using an integer. Generating a random character is to generate 
an integer. 

Computer programs process numeric data and characters. You have seen many examples 
involving numeric data. It is also important to understand characters and how to process them. 
This section gives an example of generating random ASCII characters. 

As introduced in Section 3.3, every ASCII character has a unique ASCII code between 0 
and 127. To generate a random ASCII character, first generate a random integer between 0 
and 127, and then use the chr function to obtain the character from the integer using the fol¬ 
lowing code: 

chrfrandi nt(0, 127)) 

Let’s consider how to generate a random lowercase letter. The ASCII codes for lowercase let¬ 
ters are consecutive integers starting with the code for a, then for b, c, ..., and z. The code for a is 

ord('a') 

So a random integer between ordC' a' ) and ord(' z ') is 
rand-int(ord('a') , ord('z')) 

Therefore, a random lowercase letter is 
chr(randint(ord(’,:.') , ord('z'))) 

Thus, a random character between any two characters chi and ch2 with chi < ch2 can 
be generated as follows: 

chrfrandint(ord(chl), ord(ch2))) 

This is a simple but useful discovery. In Listing 6.11 we create a module named 
RandomCharacter. py with five functions that randomly generate specific types of charac¬ 
ters. You can use these functions in your future projects. 

Listing 6.11 RandomCharacter. py 

1 from random import randint # import randint 

2 

3 # Generate a random character between chi and ch2 

4 def getRandomCharacterfchl, ch2): 

5 return chrfrandint(ord(chl), ord(ch2))) 

6 

7 # Generate a random lowercase letter 

8 def getRandomLowerCaseLetterO : 

9 return getRandomGharacter('a', 'z') 

10 

11 # Generate a random uppercase letter 

12 def getRandomUpperCaseLetterO : 

13 return getRandomGharacterC'A', 'Z') 

14 

15 # Generate a random digit character 

16 def getRandomDigitCharacterO : 

17 return getRandomGharacterC'O', '9') 

18 

19 # Generate a random character 

20 def getRandomASCIICharacterO : 

21 return chrfrandi nt(0 , 127)) 
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Listing 6.12 is a test program that displays 175 random lowercase letters. 

Listing 6.12 TestRandomCharacter.py 

1 import RandomCharacter 

2 

3 NUMBER_OF_CHARS = 175 # Number of characters to generate 

4 CHARS_PER_LINE = 25 # Number of characters to display per line 

5 

6 # Print random characters between 'a' and 'z', 25 chars per line 

7 for i in range(NUMBER_OF_CHARS): 

8 print(RandomCharacter.getRandomLowerCaseLetterO, end = ) 

9 if (i + 1) % CHARS_PER_LINE == 0: 

10 printO # lump to the new line 



gmjsohezfkgtazqgmswfcl rao 
pnrunulnwmaztlfjedmpchci f 
1alqdgivxkxpbzulrmqmbhikr 
1bnrjlsopfxahssqhwuul jvbe 
xbhdotzhpehbqmuwsfktwsol i 
cbuwkzgxpmtzihgatdslvbwbz 
bfesoklwbhnooygi i gzdxuqni 


Line 1 imports the RandomCharacter module, because the program invokes the function 
defined in this module. 

Invoking getRandomLowerCaseLetterO returns a lowercase letter (line 8). 

Note that the function getRandomLowerCaseLetterO does not have any parameters, 
parentheses required but you Still have to use the parentheses when defining and invoking it. 
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MyProgrammingLab" 

6.26 


6.27 


6.13 


Write an expression that returns a random integer between 34 and 55, inclusively. 
Write an expression that returns a random character between B and M, inclusively. 
Write an expression that returns a random number between 6.5 and 56.5 (excluding 
56.5). 

Write an expression that returns a random lowercase letter. 

Function Abstraction and Stepwise Refinement 


rr/Key 
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Function abstraction is achieved by separating the use of a function from its 
implementation. 


function abstraction 


information hiding 



VideoNote 

Divide and conquer 


divide and conquer 


The key to developing software is to apply the concept of abstraction. You will learn many 
levels of abstraction from this book. Function abstraction separates the use of a function from 
its implementation. A client program, called simply the client, can use a function without 
knowing how it is implemented. The details of the implementation are encapsulated in the 
function and hidden from the client that invokes the function. This is known as information 
hiding or encapsulation. If you decide to change the implementation, the client program will 
not be affected, provided that you do not change the function header. The implementation of 
the function is hidden from the client in a “black box,” as shown in Figure 6.5. 

You have already used many of Python’s built-in functions; you used these in client pro¬ 
grams. You know how to write the code to invoke these functions in your program, but as a 
user of these functions, you are not required to know how they are implemented. 

The concept of function abstraction can be applied to the process of developing programs. 
When writing a large program, you can use the “divide-and-conquer” strategy, also known as 
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Optional arguments Optional return 
for input value 


1 t 



Black box 


Figure 6.5 The function body can be thought of as a black box that contains the detailed 
implementation of the function. 


stepwise refinement, to break down the problem into subproblems. The subproblems can be 
further divided into smaller, more manageable ones. 

Suppose you write a program that displays the calendar for a given month of the year. The 
program prompts the user to enter the year and the month, and then it displays the entire cal¬ 
endar for the month, as shown in the following sample run: 


Enter full year (e.g., 2001): 2011 | 

Enter month as number between 1 and 12: 9 Enter| 

September 2011 


Sun 

Mon 

Tue 

Wed 

Thu 

1 

Fri 

2 

Sat 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

25 

26 

27 

28 

29 

30 



Let’s use this example to demonstrate the divide-and-conquer approach. 


6.13.1 Top-Down Design 

How would you get started writing such a program? Would you immediately start coding? 
Beginning programmers often start by trying to work out the solution to every detail. 
Although details are important in the final program, concern for detail in the early stages may 
block the problem-solving process. To make problem solving flow as smoothly as possible, 
this example begins by using function abstraction to isolate details from design and only later 
implements the details. 

For this example, the problem is first broken into two subproblems: (1) get input from the 
user and (2) print the calendar for the month. At this stage, you should be concerned with 
what the subproblems will achieve, not with how to get input and print the calendar for the 
month. You can draw a structure chart to help visualize the decomposition of the problem (see 
Figure 6.6a). 

You can use the i nput function to read input for the year and the month. The problem of 
printing the calendar for a given month can be broken into two subproblems: (1) print the 
month title and (2) print the month body, as shown in Figure 6.6b. The month title consists of 
three lines: month and year, a dashed line, and the names of the seven days of the week. You 
need to get the month name (e.g., January) from the numeric month (e.g., 1). This is accom¬ 
plished in getMonthName (see Figure 6.7a). 


stepwise refinement 
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printCalendar 
(man n) 



readinput | printMonth 

(a) 


f 



1 


printMonthTitle [ printMonthBody | 


(b) 


Figure 6.6 The structure chart shows that the pri ntCal endar problem is divided into two subproblems, readinput 
and printMonth, and that printMonth is divided into two smaller subproblems, printMonthTitle and 
printMonthBody. 


printMonthBody | 

pri ntMonthTi t1 e | 

I \ 

getMonthName | getStartPay | getNumberOfPaysInMonth | 

(a) (b) 

Figure 6.7 (a) To pri ntMonthTi tl e, you need getMonthName. (b) The pri ntMonthBody 

problem is refined into several smaller problems. 


In order to print the month body, you need to know which day of the week is the first day of 
the month (getStartDay) and how many days the month has (getNumberOfDaysInMonth), 
as shown in Figure 6.7b. For example, December 2005 has 31 days, and December 1, 2005, is a 
Thursday. 

How would you get the start day for the first date in a month? There are several ways 
to do so. Assume you know that the start day for January 1, 1800, was Wednesday 
(START_DAY_F0R_3AN_1_1800 = 3). You could compute the total number of days 

(total NumberOfDays) between January 1, 1800, and the first date of the calendar month. 
The start day for the calendar month is (total NumberOfDays + startDaylSOO) % 7, 
since every week has seven days. Thus, the getStartDay problem can be further refined as 
getTotal NumberOfDays, as shown in Figure 6.8a. 


getStartPay 


getTotalNumberOfPays 


(a) 


getTotalNumberOfPays | 


getNumberOfPaysInMonth | 


isLeapYear | 


(b) 


Figure 6.8 (a) To getStartDay, you need getTotal NumberOfDays. (b) The 

getTotal NumberOfDays problem is refined into two smaller problems. 


To get the total number of days, you need to know whether the year is a leap year and the 
number of days in each month. Therefore, getTotal NumberOfDays needs to be further 
refined into two subproblems: isLeapYear and getNumberOfDaysInMonth, as shown in 
Figure 6.8b. The complete structure chart is shown in Figure 6.9. 
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pri ntCalendar 
(man n) 


r“ 

readlnput 


I 

printMonthTitle I printMonthBody 

T I 

getMonthName getStartDay 


T 


getTotalNumberOfDays 




' - 1 


getNumberOfDaysInMonth 

f ' 


1 sLeapYear 


Figure 6.9 The structure chart shows the hierarchical relationship of the subproblems in 
the program. 


T 

printMonth 


6.13.2 Top-Down and/or Bottom-Up Implementation 

Now let’s turn our attention to implementation. In general, a subproblem corresponds to 
a function in the implementation, although some are so simple that this is unnecessary. 
You need to decide which modules to implement as functions and which to combine in other 
functions. Decisions of this kind should be based on the way that the overall program will be 
easier to read. In this example, the subproblem readlnput can be simply implemented in the 
main function. 

You can use either a “top-down” or a “bottom-up” approach. The top-down approach 
implements one function in the structure chart at a time from the top to the bottom. A stub, 
which is a simple but incomplete version of a function, can be used for the functions waiting 
to be implemented. Stubs enable you to build the framework of a program quickly. Implement 
the main function first, then use a stub for the pri ntMonth function. For example, let 
pri ntMonth display the year and the month in the stub. Thus, your program may begin 
like this: 


# A stub for printMonth may look like this 
def printMonthCyear, month): 

printCyear, month) 

# A stub for printMonthTitle may look like this 
def printMonthTitlefyear, month): 

pri ntC'printMonthTitle") 

# A stub for getMonthBody may look like this 
def getMonthBodyCyear, month): 

pri ntC'getMonthBody") 

# A stub for getMonthName may look like this 
def getMonthName(month): 

pri ntC'getMonthName' ) 


top-down approach 
stub 
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driver 


# A Stub for getStartDay may look like this 
def getStartDay(year, month) : 

pri ntC'getStartDay") 

# A stub for getTotalNumberOfDays may look like this 
def getTotalNumberOfDaysCyear, month): 

pri ntC'getTotalNumberOfDays") 

# A stub for getNumberOfDaysInMonth may look like this 
def getNumberOfDaysInMonth(year, month): 

pri nt ("getNumberOfDaysInMonth") 

# A stub for isLeapYear may look like this 
def isLeapYear(year) : 

pri ntC'isLeapYear") 

def main(): 

# Prompt the user to enter year and month 

year = eval(i nput("Enter full year (e.g., 2001): ")) 
month = eval(input(( 

"Enter month as number between 1 and 12: "))) 

# Print calendar for the month of the year 
printMonth(year, month) 

mainO # Call the main function 

Run and test the program, and fix any errors. You can now implement the printMonth 
function. For functions invoked from the printMonth function, you can again use stubs. 

The bottom-up approach implements one function in the structure chart at a time from the bot¬ 
tom to the top. For each function implemented, write a test program, known as the driver, to test it. 

The top-down and bottom-up approaches are both fine. Both approaches implement func¬ 
tions incrementally, help to isolate programming errors, and make debugging easy. They can 
be used together. 


6.13.3 Implementation Details 

The isLeapYear(year) function can be implemented using the following code (see 
Section 4.12): 

return year % 400 == 0 or (year % 4 == 0 and year % 100 != 0) 

Use the following facts to implement getTotal NumberOfDaysInMonthCyear, month) : 

■ January, March, May, July, August, October, and December have 31 days. 

■ April, June, September, and November have 30 days. 

■ February has 28 days during a regular year and 29 days during a leap year. A regular 
year, therefore, has 365 days, and a leap year has 366 days. 

To implement getTotal NumberOfDays (year, month) , you need to compute the total 
number of days (total NumberOfDays) between January 1, 1800, and the first day of the 
calendar month. You could find the total number of days between the year 1800 and the cal¬ 
endar year and then figure out the total number of days prior to the calendar month in the cal¬ 
endar year. The sum of these two totals is total NumberOfDays. 

To print the calendar’s body, first pad some space before the start day and then print the 
lines for every week. 

The complete program is given in Listing 6.13. 
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Listing 6.13 PrintCalendar.py 

1 # Print the calendar for a month in a year 

2 def printMonthCyear, month): 

3 # Print the headings of the calendar 

4 printMonthTitle(year, month) 

5 

6 # Print the body of the calendar 

7 printMonthBody(year, month) 

8 

9 # Print the month title, e.g., May 1999 

10 def printMonthTitleCyear, month): 


11 print(" , getMonthName(month), , year) 

12 printC' — - - -") 


13 print( Sun Mon Tue Wed Thu Fri Sat") 

14 

15 # Print month body 

16 def printMonthBody(year, month): 

17 # Get start day of the week for the first date in the month 

18 startDay = getStartDay(year, month) 

19 

20 # Get number of days in the month 

21 numberOfDaysInMonth = getNumberOfDaysInMonth(year, month) 

22 

23 # Pad space before the first day of the month 

24 i = 0 

25 for i in range(0, startDay): 

26 print( , end = ) 

27 

28 for i in range(l, numberOfDaysInMonth + 1): 

29 print(format(i, "4d'') , end = ) 

30 

31 if (i + StartDay) % 7 == 0: 

32 printO # lump to the new line 

33 

34 # Get the English name for the month 

35 def getMonthName(month): 

36 if month == 1: 


37 

monthName 

= "January" 

38 

el if month == 

2: 

39 

monthName 

= "February" 

40 

el if month == 

3: 

41 

monthName 

= "March" 

42 

el if month == 

4: 

43 

monthName 

= "April" 

44 

el if month == 

5: 

45 

monthName 

= "May" 

46 

el if month == 

6: 

47 

monthName 

= "June" 

48 

el if month == 

7: 

49 

monthName 

= "July" 

50 

el if month == 

8: 

51 

monthName 

= "August" 

52 

el if month == 

9: 

53 

monthName 

= "September 

54 

el if month == 

10: 

55 

monthName 

= "October" 

56 

el if month == 

11: 

57 

monthName 

= "November" 


printMonth 


printMonthTitle 


printMonthBody 


getMonthName 
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else: 

monthName = ''December" 
return monthName 

# Get the start day of month/l/year 
def getStartDay(year, month): 

START_DAY_FOR_3AN_1_1800 = 3 

# Get total number of days from 1/1/1800 to month/l/year 
totalNumberOfDays = getTotalNumberOfDays(year, month) 

# Return the start day for month/l/year 

return (totalNumberOfDays + START_DAY_FOR_3AN_l_18O0) % 7 

# Get the total number of days since January 1, 1800 
def getTotalNumberOfDays(year, month): 

total = 0 

# Get the total days from 1800 to 1/1/year 
for i in range(1800, year): 

if isLeapYear(i): 

total = total + 366 

else: 

total = total + 365 

# Add days from Jan to the month prior to the calendar month 
for i in range(l, month): 

total = total + getNumberOfDaysInMonth(year, i) 

return total 

# Get the number of days in a month 

def getNumberOfDaysInMonth(year, month): 

if (month == 1 or month == 3 or month == 5 or month == 7 or 
month == 8 or month == 10 or month == 12) : 

return 31 

if month == 4 or month == 6 or month == 9 or month == 11: 

return 30 

if month == 2: 

return 29 if isLeapYear(year) else 28 
return 0 # If month is incorrect 

# Determine if it is a leap year 
def isLeapYear(year): 

return year % 400 == 0 or (year % 4 == 0 and year % 100 != 0 
def mai n(): 

# Prompt the user to enter year and month 

year = eval(i nput("Enter full year (e.g., 2001): )) 

month = eval (i nput(("Enter month as number between 1 and 12: " 

# Print calendar for the month of the year 
printMonth(year, month) 

mainO # Call the main function 
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This program does not validate user input. For instance, if the user enters either a month 
not in the range between 1 and 12 or a year before 1800, the program displays an erroneous 
calendar. To avoid this error, add an i f statement to check the input before printing the 
calendar. 

This program prints calendars for a month but could easily be modified to print calendars 
for a whole year. Although it can print months only after January 1800, it could be modified 
to print months before 1800. 

6.13.4 Benefits of Stepwise Refinement 

Stepwise refinement breaks a large problem into smaller manageable subproblems. Each sub¬ 
problem can be implemented using a function. This approach makes the program easier to 
write, reuse, debug, test, modify, and maintain. 

Simpler Program 

The print calendar program is long. Rather than writing a long sequence of statements in one 
function, stepwise refinement breaks it into smaller functions. This simplifies the program 
and makes the whole program easier to read and understand. 

Reusing Functions 

Stepwise refinement promotes code reuse within a program. The isLeapYear function is 
defined once and invoked from the getTotal NumberOfDays and getNumberOfDasInMonth 

functions. This reduces redundant code. 

Easier Developing, Debugging, and Testing 

Since each subproblem is solved in a function, a function can be developed, debugged, and 
tested individually. This isolates the errors and makes developing, debugging, and testing 
easier. 

When implementing a large program, use the top-down and/or bottom-up approach. Do 
not write the entire program at once. Using these approaches seems to take more development 
time (because you repeatedly run the program), but it actually saves time and makes debug¬ 
ging easier. 

Better Facilitating Teamwork 

Since a large problem is divided into subprograms, the subproblems can be assigned to pro¬ 
grammers. This makes it easier for programmers to work in teams. 

6.14 Case Study: Reusable Graphics Functions 

You can develop reusable functions to simplify coding in the turtle module. 

Often you need to draw a line between two points, display text or a small point at a speci¬ 
fied location, depict a circle with a specified center and radius, or create a rectangle with a 
specified center, width, and height. It would greatly simplify programming if these func¬ 
tions were available for reuse. Listing 6.14 defines these functions in a module named 

UsefulTurtleFunctions. 

Listing 6.14 UsefulTurtleFunctions.py 

1 import turtle 

2 

3 # Draw a line from (xl, yl) to (x2, y2) 

4 def drawLine(xl, yl, x2, y2): 

5 turtl e. penupO 


incremental development and 
testing 


c/Key 
>P / Point 


import turtle 


function drawLl ne 
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draw a line 

function wri teText 

write string 

function drawPoi nt 

draw a tiny circle 

function drawCi rcl e 

draw a circle 

function drawRectangl e 


import turtle 
import 

UsefulTurtleFunctions 
draw a line 

write text string 

draw a point 


6 turtle.goto(xl, yl) 

7 turtle.pendownO 

8 turtle.goto(x2, y2) 

9 

10 # Write a string s at the specified location (x, y) 

11 def writeText(s, x, y): 

12 turtle.penupO # Pull the pen up 

13 turtle.goto(x, y) 

14 turtle.pendownO # Pull the pen down 

15 turtle.write(s) # Write a string 

16 

17 # Draw a point at the specified location (x, y) 

18 def drawPoint(x, y): 

19 turtle.penupO # Pull the pen up 

20 turtle.goto(x, y) 

21 turtle.pendownO # Pull the pen down 

22 turtle.begin_fi11O # Begin to fill color in a shape 

23 turtle.circl e(3) 

24 turtle.end_fi11() # Fill the shape 

25 

26 # Draw a circle centered at (x, y) with the specified radius 

27 def drawCircle(x =0, y = 0, radius = 10): 

28 turtle.penupO # Pull the pen up 

29 turtle.goto(x, y - radius) 

30 turtle.pendownO # Pull the pen down 

31 turtle.circle(radius) 

32 

33 # Draw a rectangle at (x, y) with the specified width and height 

34 def drawRectangle(x =0, y = 0, width = 10, height = 10): 

35 turtle.penupO # Pull the pen up 

36 turtle.goto(x + width / 2, y + height / 2) 

37 turtle.pendownO # Pull the pen down 

38 turtle. right(90) 

39 turtle.forward(height) 

40 turtle. right(90) 

41 turtle.forward(width) 

42 turtle. right(90) 

43 turtle.forward(height) 

44 turtle. right(90) 

45 turtle.forward(width) 

Now that you have written this code, you can use these functions to draw shapes. Listing 6.15 
gives a test program to use these functions from the Useful Turtl eFuncti ons module to draw 
a line, write some text, and create a point, a circle, and a rectangle, as shown in Figure 6.10. 

Listing 6.15 UseCustomTurtleFunctions.py 

1 import turtle 

2 from UsefulTurtleFunctions import * 

3 

4 # Draw a line from (-50, -50) to (50, 50) 

5 drawLine(-50, -50, 50, 50) 

6 

7 # Write text at (-50, -60) 

8 writeText(’'Testing useful Turtle functions", -50, -60) 

9 

10 # Draw a point at (0, 0) 

11 drawPoint(0, 0) 

12 

13 # Draw a circle at (0, 0) with radius 80 
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14 

15 

drawCircl e(0 , 0, 80) 

draw a circle 

16 

# Draw a rectangle at (0, 0) with width 60 and height 40 


17 

18 

drawRectangleCO, 0, 60, 40) 

draw a rectangle 

19 

turtle.hideturtle() 


20 

turtl e. doneO 

pause 



Figure 6.10 The program draws shapes using the custom functions. 


The asterisk (*) in line 2 imports all functions from the UsefulTurtl eFunctions mod¬ 
ule into the program. Line 5 invokes the drawLi ne function to draw a line, and line 8 invokes 
the writeText function to write a text string. The drawPoint function (line 11) draws a 
point, and the drawCircle function (line 14) draws a circle. Line 17 invokes the 
drawRectangle function to draw a rectangle. 
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Chapter Summary 


1. Making programs modular and reusable is one of the central goals in software engi¬ 
neering. Functions can help to achieve this goal. 

2. A function header begins with the def keyword followed by function’s name and 
parameters, and ends with a colon. 


3. Parameters are optional; that is, a function does not have to contain any parameters. 
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4 . A function is called a void or None function if it does not return a value. 

5 . A return statement can also be used in a void function for terminating the function 
and returning to the function’s caller. This is useful occasionally for circumventing 
the normal flow of control in a function. 

6 . The arguments that are passed to a function should have the same number, type, and 
order as the parameters in the function header. 

7. When a program calls a function, program control is transferred to the called func¬ 
tion. A called function returns control to the caller when its return statement is exe¬ 
cuted or when the last statement in the function is executed. 

8 . A value-returning function can also be invoked as a statement in Python. In this case, 
the function’s return value is ignored. 

9. A function’s arguments can be passed as positional arguments or keyword arguments. 

10. When you invoke a function with a parameter, the reference value of the argument 
is passed to the parameter. This is referred to as pass-by-value in programming 
terminology. 

11. A variable created in a function is called a loccd variable. The scope of a local vari¬ 
able starts from its creation and exists until the function returns. A variable must be 
created before it is used. 

12. Global variables are created outside all functions and are accessible to all functions 
in their scope. 

13. Python allows you to define functions with default argument values. The default val¬ 
ues are passed to the parameters when a function is invoked without the arguments. 

14 . The Python return statement can return multiple values. 

1 5 . Function abstraction is achieved by separating the use of a function from its imple¬ 
mentation. The client can use a function without knowing how it is implemented. The 
details of the implementation are encapsulated in the function and hidden from the 
client that invokes the function. This is known as information hiding or encapsulation. 

16. Function abstraction modularizes programs in a neat, hierarchical manner. Programs 
written as collections of concise functions are easier to write, debug, maintain, and 
modify than would otherwise be the case. This writing style also promotes function 
reusability. 

17. When implementing a large program, use the top-down and/or bottom-up coding 
approach. Do not write the entire program at once. This approach may seem to take 
more time for coding (because you are repeatedly running the program), but it actu¬ 
ally saves time and makes debugging easier. 

Test Questions 


Do test questions for this chapter online at www.cs.armstrong.edu/liang/py/test.html. 
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Programming Exercises 


Sections 6.2-6.9 

6.1 {Math: pentagonal numbers) A pentagonal number is defined as n{3n — l)/2 for 
n = 1, 2, ... , and so on. So, the first few numbers are 1, 5, 12, 22, .... Write a 
function with the following header that returns a pentagonal number: 

def getPentagonalNumber(n): 

Write a test program that uses this function to display the first 100 pentagonal 
numbers with 10 numbers on each line. 

*6.2 (Sum the digits in an integer) Write a function that computes the sum of the digits 
in an integer. Use the following function header: 

def sumDigits(n): 

For example, suniDigits(234) returns 9 (2 + 3 + 4). (Hint: Use the % operator 
to extract digits, and the // operator to remove the extracted digit. For instance, to 
extract 4 from 234, use 234 % 10 (= 4). To remove 4 from 234, use 234 // 10 
(= 23). Use a loop to repeatedly extract and remove the digits until all the digits 
are extracted.) Write a test program that prompts the user to enter an integer and 
displays the sum of all its digits. 

**6.3 {Palindrome integer) Write the functions with the following headers: 

# Return the reversal of an integer, e.g. reverse(456) returns 

# 654 

def reverse(number): 

# Return true if number is a palindrome 
def isPalindrome(number): 

Use the reverse function to implement isPal indrome. A number is a palin¬ 
drome if its reversal is the same as itself. Write a test program that prompts the 
user to enter an integer and reports whether the integer is a palindrome. 

*6.4 {Display an integer reversed) Write the following function to display an integer in 
reverse order: 

def reverse(number): 

For example, reverseC3456) displays 6543. Write a test program that prompts 
the user to enter an integer and displays its reversal. 

*6.5 {Sort three numbers) Write the following function to display three numbers in 
increasing order: 

def displaySortedNumbers(numl, num2, num3): 

Write a test program that prompts the user to enter three numbers and invokes the 
function to display them in increasing order. Here are some sample runs: 


Enter three numbers: 3, 2.4, 5 Enter 
The sorted numbers are 2.4 3 5 


MyProgrammingLab" 
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Enter three numbers: 31, 12.4, 15 -"Enter| 
The sorted numbers are 12.4 15 31 


*6.6 {Display patterns) Write a function to display a pattern as follows: 

1 

2 1 
3 2 1 

n n-1 ... 3 2 1 
The function header is 
def displayPattern(n): 

Write a test program that prompts the user to enter a number n and invokes 
displayPatternCn) to display the pattern. 

*6.7 {Financial application: compute the future investment value) Write a function that 
computes a future investment value at a given interest rate for a specified number of 
years. The future investment is determined using the formula in Exercise 2.19. 

Use the following function header: 

def futureInvestmentValue( 

investmentAmount, monthlyInterestRate, years): 

For example, futureInvestmentValue(10000, 0.05/12, 5) returns 

12833.59. 

Write a test program that prompts the user to enter the investment amount and the 
annual interest rate in percent and prints a table that displays the future value for 
the years from 1 to 30. Here is a sample run: 



The amount invested: 1000 | 

Annual 

interest rate: 9 Enter| 

Years 

Future Value 

1 

1093.80 

2 

1196.41 

29 

13467.25 

30 

14730.57 


6.8 {Conversions between Celsius and Fahrenheit) Write a module that contains the 
following two functions: 

# Converts from Celsius to Fahrenheit 
def celsiusToFahrenheit(celsius): 

# Converts from Fahrenheit to Celsius 
def fahrenheitToCelsius(fahrenheit): 

The formulas for the conversion are: 

Celsius = (5 / 9) * (fahrenheit - 32) 
fahrenheit = (9 / 5) * Celsius + 32 
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Write a test program that invokes these functions to display the following tables: 


Ce1 si us 

Fahrenheit 

1 Fahrenheit 

Ce1 si us 

40.0 

104.0 

1 120.0 

48.89 

39.0 

102.2 

1 110.0 

43.33 

32.0 

89.6 

1 40.0 

4.44 

31.0 

87.8 

1 30.0 

-1.11 


6.9 {Conversions between feet and meters) Write a module that contains the following 

two functions: 

# Converts from feet to meters 
def footToMeter(foot): 

# Converts from meters to feet 
def meterToFoot(meter) : 

The formulas for the conversion are: 

foot = meter / 0.305 
meter = 0.305 * foot 

Write a test program that invokes these functions to display the following tables: 


Feet 

Meters 

1 Meters 

Feet 

1.0 

0.305 

1 20.0 

66.574 

2.0 

0.610 

1 26.0 

81.967 

9.0 

2.745 

1 60.0 

196.721 

10.0 

3.050 

1 66.0 

213.115 


6.10 (Use the isPrime Function) Listing 6.7, PrimeNumberFunction.py, provides the 
isPrime(number) function for testing whether a number is prime. Use this 
function to find the number of prime numbers less than 10,000. 


6.1 I {Financial application: compute commissions) Write a function that computes 
the commission, using the scheme in Exercise 5.39. The header of the function is: 

def computeCommission(salesAmount): 


Write a test program that displays the following table: 


Sales Amount 


Commission 


10000 

15000 

95000 

100000 


900.0 

1500.0 

11100.0 

11700.0 


6.12 {Display characters) Write a function that prints characters using the following 
header: 


def printChars(chl, ch2, numberPerLine): 

This function prints the characters between chi and ch2 with the specified 
numbers per line. Write a test program that prints ten characters per line from 1 

to Z. 
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*6.13 (Sum series) Write a function to compute the following series: 

1 2 i 

m(i) = -1-h . . . H- 

2 3 i + 1 


Write a test program that displays the following table: 


i m(i) 

1 0.5000 

2 1.1667 


19 16.4023 

20 17.3546 


^6.14 {Estimate tt) tt can be computed using the following series: 


11111 

m{i) = 4 1-^-1-h 

' 3 5 7 9 11 


i+i 


+ 


(- 1 ) 

2i - 1 


Write a function that returns m(i ) for a given i and write a test program that dis¬ 
plays the following table: 


i 


1 

4.0000 

101 

3.1515 

201 

3.1466 

301 

3.1449 

401 

3.1441 

501 

3.1436 

601 

3.1433 

701 

3.1430 

801 

3.1428 

901 

3.1427 


*6.15 {Financial application: print a tax table) Listing 4.7, ComputeTax.py, gives a 
program to compute tax. Write a function for computing tax using the following 
header: 


def computeTaxfstatus, taxableincome): 

Use this function to write a program that prints a tax table for taxable income from 
$50,000 to $60,000 with intervals of $50 for all four statuses, as follows: 


Taxable 

Income 

Single 

Married 

Joint 

Married 

Separate 

Head of 
a House 

50000 

8688 

6665 

8688 

7352 

50050 

8700 

6673 

8700 

7365 

59950 

11175 

8158 

11175 

9840 

60000 

11188 

8165 

11188 

9852 


*6.1 6 {Number of days in a year) Write a function that returns the number of days in a 
year using the following header: 

def numberOfDaysInAYear(year): 

Write a test program that displays the number of days in the years from 2010 to 
2020 . 




Programming Exercises 207 


Sections 6.10-6.11 

*6.17 {The MyTriangle module) Create a module named MyTriangle that contains 
the following two functions: 

# Returns true if the sum of any two sides is 

# greater than the third side, 
def isVaiidfsidel, side2, side3): 

# Returns the area of the triangle, 
def areafsidel, side2, side3): 

Write a test program that reads three sides for a triangle and computes the area if the 
input is valid. Otherwise, it displays that the input is invalid. The formula for com¬ 
puting the area of a triangle is given in Exercise 2.14. Here are some sample runs: 


Enter three sides in double: 1, 3, 1 
Input is invalid 



Enter three sides in double: 1, 1, 1 Enter 
The area of the triangle is 0.4330127018922193 



* 6 . 18 (Display matrix of Os and Is) Write a function that displays an n-hy-n matrix using 
the following header: 

def printMatrix(n): 

Each element is 0 or 1, which is generated randomly. Write a test program that 
prompts the user to enter n and displays an n-hy-n matrix. Here is a sample run: 


Enter n: 3 
0 10 
0 0 0 
111 


* 6.19 (Geometry: point position) Exercise 4.31 shows how to test whether a point is on 
the left side of a directed line, on the right, or on the same line. Write the follow¬ 
ing functions: 

# Return true if point (x2, y2) is on the left side of the 

# directed line from (xO, yO) to (xl, yl) 
def 1eftOfTheLine(x0, yO, xl, yl, x2, y2): 

# Return true if point (x2, y2) is on the same 

# line from (xO, yO) to (xl, yl) 

def onTheSameLineCxO, yO, xl, yl, x2, y2): 

# Return true if point (x2, y2) is on the 

# line segment from (xO, yO) to (xl, yl) 

def onTheLineSegment(x0, yO, xl, yl, x2, y2): 
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Write a program that prompts the user to enter the three points for pO, pi, and p2 
and displays whether p2 is on the left of the line from pO to pi, on the right, on the 
same line, or on the line segment. The sample runs of this program are the same as 
in Exercise 4.31. 

*6.20 (Geometry: display angles) Rewrite Listing 2.9, ComputeDistance.py, using the 
following function for computing the distance between two points. 

def distancefxl, yl, x2, y2): 

**6.21 (Math: approximate the square root) There are several techniques for implement¬ 
ing the sqrt function in the math module. One such technique is known as the 
Babylonian function. It approximates the square root of a number, n, by repeatedly 
performing a calculation using the following formula: 

nextCuess = (lastCuess + (n / lastCuess)) / 2 

When nextCuess and lastCuess are almost identical, nextCuess is the 
approximated square root. The initial guess can be any positive value (e.g., 1). 
This value will be the starting value for lastCuess. If the difference between 
nextCuess and lastCuess is less than a very small number, such as 0.0001, 
you can claim that nextCuess is the approximated square root of n. If not, 
nextCuess becomes ''astCuess and the approximation process continues. 
Implement the following function that returns the square root of n. 

def sqrt(n): 


Sections 6.12-6.13 

**6.22 (Display current date and time) Listing 2.7, ShowCurrentTime.py, displays the 
current time. Enhance this program to display the current date and time. (Hint: The 
calendar example in Listing 6.13, PrintCalendar.py, should give you some ideas on 
how to find the year, month, and day.) 

**6.23 (Convert milliseconds to hours, minutes, and seconds) Write a function that con¬ 
verts milliseconds to hours, minutes, and seconds using the following header: 

def convertMi Hi s(mi Ills): 

The function returns a string as hours:minutes:seconds. Lor example, 

convertMillis(5500) returns the string 0:0:5, convertMillis(lOOOOO) 

returns the string 0:1:40, and convertMillis(555550000) returns the string 
154:19:10. 

Write a test program that prompts the user to enter a value for milliseconds and 
displays a string in the format of hours:minutes:seconds. 

**6.24 (Palindromic prime) A palindromic prime is a prime number that is also palin¬ 
dromic. Lor example, 131 is a prime and also a palindromic prime, as are 313 and 
757. Write a program that displays the first 100 palindromic prime numbers. Dis¬ 
play 10 numbers per line and align the numbers properly, as follows: 

2 3 5 7 11 101 131 151 181 191 

313 353 373 383 727 757 787 797 919 929 
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**6.25 (Emirp) An emirp (prime spelled backward) is a nonpalindromic prime number 
whose reversal is also a prime. For example, both 17 and 71 are prime numbers, so 
17 and 71 are emirps. Write a program that displays the first 100 emirps. Display 
10 numbers per line and align the numbers properly, as follows: 

13 17 31 37 71 73 79 97 107 113 

149 157 167 179 199 311 337 347 359 389 

**6.26 (Mersenne prime) A prime number is called a Mersenne prime if it can be written 
in the form 2^—1 for some positive integer p. Write a program that finds all 
Mersenne primes with p < 31 and displays the output as follows: 

p 2Ap - 1 

2 3 

3 7 

5 31 

**6.27 (Twin primes) Twin primes are a pair of prime numbers that differ hy 2. For exam¬ 
ple, 3 and 5, 5 and 7, and 11 and 13 are twin primes. Write a program to find all 
twin primes less than 1,000. Display the output as follows: 

(3, 5) 

(5, 7)... 

**6.28 (Game: craps) Craps is a popular dice game played in casinos. Write a program to 
play a variation of the game, as follows: 

Roll two dice. Each die has six faces representing values 1, 2, ..., and 6, respec¬ 
tively. Check the sum of the two dice. If the sum is 2, 3, or 12 (called craps), you 
lose; if the sum is 7 or 11 (called natural), you win; if the sum is another value 
(i.e., 4, 5, 6, 8, 9, or 10), a point is established. Continue to roll the dice until either 
a 7 or the same point value is rolled. If 7 is rolled, you lose. Otherwise, you win. 

Your program acts as a single player. Here are some sample runs. 













210 Chapter 6 


Functions 


**6.29 {Financial: credit card number validation) Credit card numbers follow certain 
patterns: It must have between 13 and 16 digits, and the number must start with: 

■ 4 for Visa cards 

■ 5 for MasterCard credit cards 

■ 37 for American Express cards 

■ 6 for Discover cards 

In 1954, Hans Luhn of IBM proposed an algorithm for validating credit card num¬ 
bers. The algorithm is useful to determine whether a card number is entered cor¬ 
rectly or whether a credit card is scanned correctly by a scanner. Credit card 
numbers are generated following this validity check, commonly known as the 
Luhn check or the Mod 10 check, which can be described as follows (for illustra¬ 
tion, consider the card number 4388576018402626): 

1. Double every second digit from right to left. If doubling of a digit results in a 
two-digit number, add up the two digits to get a single-digit number. 


4388576018402626 



2*2 = 4 
2*2 = 4 
4*2 = 8 
1*2 = 2 

6*2 = 12 ( 1+2 = 3 ) 
5*2 = 10 (1 + 0 = 1 ) 
8*2 = 16 (1 + 6 = 7 ) 
4*2 = 8 


2. Now add all single-digit numbers from Step 1. 

4 + 44-8 + 2-13-1-1-17 + 8 = 37 

3. Add all digits in the odd places from right to left in the card number. 

6 + 6 + 0 + 8 + 0 + 7 + 8 + 3 = 38 

4. Sum the results from Steps 2 and 3. 

37 + 38 = 75 

5. If the result from Step 4 is divisible by 10, the card number is valid; otherwise, 
it is invalid. For example, the number 4388576018402626 is invalid, but the 
number 4388576018410707 is valid. 

Write a program that prompts the user to enter a credit card number as an integer. 
Display whether the number is valid or invalid. Design your program to use the 
following functions: 

# Return true if the card number is valid 
def isValid(number): 

# Get the result from Step 2 

def sumOfDoubleEvenPlace(number): 

# Return this number if it is a single digit, otherwise, return 

# the sum of the two digits 
def getDigit(number): 

# Return sum of odd place digits in number 
def sumOfOddPlace(number): 
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# Return true if the digit d is a prefix for number 
def prefixMatched(number, d): 

# Return the number of digits in d 
def getSize(d): 

# Return the first k number of digits from number. If the 

# number of digits in number is less than k, return number, 
def getPrefix(number, k): 


**6.30 (Game: chance of winning at craps) Revise Exercise 6.28 to run it 10,000 times 
and display the number of winning games. 

***6.3 i (Current date and time) Invoking time. timeC) returns the elapsed time in sec¬ 
onds since midnight of January 1, 1970. Write a program that displays the date 
and time. Here is a sample run: 


Current date and time is May 16, 2012 10:34:23 



**6.32 (Print calendar) Exercise 4.21 uses Zeller’s congruence to calculate the day of 
the week. Simplify Listing 6.13, PrintCalendar.py, using Zeller’s algorithm to get 
the start day of the month. 

**6.33 (Geometry: area of a pentagon) Rewrite Exercise 3.4 using the following func¬ 
tion to return the area of a pentagon: 

def area(s): 

*6.34 (Geometry: area of a regular polygon) Rewrite Exercise 3.5 using the following 
function to return the area of a regular polygon: 

def area(n, side): 

*6.35 (Compute the probability) Use the functions in RandomCharacter in Listing 
6.11 to generate 10,000 uppercase letters and count the occurrence of ,4. 

*6.36 (Generate random characters) Use the functions in RandomCharacter in 
Listing 6.11 to print 100 uppercase letters and then 100 single digits, printing ten 
per line. 

Section 6.14 

*6.37 (Turtle: generate random characters) Use the functions in RandomCharacter 
in Listing 6.11 to display 100 lowercase letters, fifteen per line, as shown in 
Figure 6.11a. 

**6.38 (Turtle: draw a line) Write the following function that draws a line from point 
(xl, yl) to (x2, y2) with color (default to black) and line size (default to 1). 

def drawLine(xl, yl, x2, y2, color = 'black", size = 1): 

**6.39 (Turtle: draw a star) Write a program that draws a star, as shown in Figure 6.1 lb. 
Use the drawLine function defined in Exercise 6.38. 
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Figure 6.11 (a) The program displays random lowercase letters, (b) The program draws a star, (c) The program draws 

random points in a rectangle and in a circle. 

** 6.40 {Turtle: filled rectangle and circle) Write the following functions that fill a rectan¬ 
gle with the specified color, center, width, and height, and a circle with the specified 
color, center, and radius. 

# Fill a rectangle 

def drawRectangle(color = "black", 

X = 0, y = , width = 30, height = 30): 


# Fi11 a circl e 

def drawCircle(color = "black", x = 0, y = 0, radius = 50): 

**6.4 1 {Turtle: draw points, rectangles, and circles) Use the functions defined in Listing 
6.14 to write a program that displays a rectangle centered at (—75, 0) with width 
and height 100 and a circle centered at (50, 0) with radius 50. Fill 10 random 
points inside the rectangle and 10 inside the circle, as shown in Figure 6.1 Ic. 

**6.42 {Turtle: plot the sine function) Simplify the code for Exercise 5.52 by using the 
functions in Listing 6.14. 

** 6.43 {Turtle: plot the sine and cosine functions) Simplify the code for Exercise 5.53 by 
using the functions in Listing 6.14. 

**6.44 {Turtle: plot the square function) Simplify the code for Exercise 5.54 by using the 
functions in Listing 6.14. 

** 6.45 {Turtle: draw a regular polygon) Write the following function to draw a regular 
polygon: 

def drawPolygon(x =0, y = 0, radius = 50, numberOfSides = 3): 


The polygon is centered at (x, y) with a specified radius for the bounding circle for 
the polygon and the number of sides. Write a test program that displays a triangle, 
square, pentagon, hexagon, heptagon, and octagon, as shown in Eigure 6.12a. 

*6.46 {Turtle: connect all points in a hexagon) Write a program that displays a hexagon 
with all the points connected, as shown in Figure 6.12b. 

* 6.47 {Turtle: two chessboards) Write a program that displays two chessboards, as 
shown in Figure 6.13. Your program should define at least the following function: 


# Draw one chessboard whose upper-left corner is at 

# (startx, starty) and bottom-right corner is at (endx, endy) 
def drawChessboard(startx, endx, starty, endy): 
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Figure 6.12 (a) The program displays several n-sided polygons, (b) The program displays a hexagon with all points 

connected. 



Figure 6.13 The program draws two chessboards. 


*6.48 {Format an integer) Write a function with the following header to format the inte¬ 
ger with the specified width. 

def format(number, width): 

The function returns a string for the number with prefix Os. The size of the string is 
the width. For example, format(34, 4) returns ”0034" and format(34, 5) 

returns "00034". If the number is longer than the width, the function returns the 
string representation for the number. For example, format(34, 1) returns "34". 

Write a test program that prompts the user to enter a number and its width and dis¬ 
plays a string returned from invoking format (number, wi dth) . Here is a sample 
run: 


Enter an integer: 453 hI 
Enter the width: 6 p^nter| 

The formatted number is 000453 
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CHAPTER 


7 

Objects and Classes 

objectives 

■ To describe objects and classes, and use classes to model objects (§7.2). 

■ To define classes with data fields and methods (§7.2.1). 

■ To construct an object using a constructor that invokes the initializer 
to create and initialize data fields (§7.2.2). 

■ To access the members of objects using the dot operator ( ) (§7.2.3). 

■ To reference an object itself with the sel f parameter (§7.2.4). 

■ To use UML graphical notations to describe classes and objects (§7.3). 

■ To distinguish between immutable and mutable objects (§7.4). 

■ To hide data fields to prevent data corruption and make classes easy 
to maintain (§7.5). 

■ To apply class abstraction and encapsulation to software 
development (§7.6). 

■ To explore the differences between the procedural paradigm and 
the object-oriented paradigm (§7.7). 
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7.1 Introduction 

Object-oriented programming enables you to develop large-scale software and GUIs 
effectively. 

Having learned the material in the preceding chapters, you are now able to solve many pro¬ 
gramming problems by using selections, loops, and functions. However, these features are not 
sufficient for developing a graphical user interface (GUI, pronounced goo-ee) or a large-scale 
software system. Suppose you want to develop the GUI shown in Figure 7.1. How would you 
program it? 
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Figure 7.1 You can create GUI objects like this using object-oriented programming. 


This chapter introduces object-oriented programming, which will build a foundation that 
enables you to develop GUIs and large-scale software systems in the upcoming chapters. 

7.2 Defining Classes for Objects 

A class defines the properties and behaviors for objects. 

Section 3.5 introduced objects and methods, and showed you how to use objects. Objects are 
created from classes. This section shows you how to define custom classes. 

Object-oriented programming (OOP) involves the use of objects to create programs. An 
object represents an entity in the real world that can be distinctly identified. For example, a 
student, a desk, a circle, a button, and even a loan can all be viewed as objects. An object has 
a unique identity, state, and behavior. 

■ An object’s identity is like a person’s Social Security number. Python automatically 
assigns each object a unique id for identifying the object at runtime. 

■ An object’s state (also known as its properties or attributes) is represented by vari¬ 
ables, called data fields. A circle object, for example, has a data field radius, 
which is a property that characterizes a circle. A rectangle object has the data 
fields width and height, which are properties that characterize a rectangle. 

■ Python uses methods to define an object’s behavior (also known as its actions). 
Recall that methods are defined as functions. You make an object perform an action 
by invoking a method on that object. For example, you can define methods named 
getAreaO and getPerimeter () for circle objects. A circle object can then 
invoke the getAreaO method to return its area and the getPerimeter () method 
to return its perimeter. 

Objects of the same kind are defined by using a common class. The relationship between 
classes and objects is analogous to that between an apple-pie recipe and apple pies. You can 
make as many apple pies (objects) as you want from a single recipe (class). 

A Python class uses variables to store data fields and defines methods to perform actions. 
A class is a contract —also sometimes called a template or blueprint —that defines what an 
object’s data fields and methods will be. 
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An object is an instance of a class, and you can create many instances of a class. Creating 
an instance of a class is referred to as instantiation. The terms object and instance are often 
used interchangeably. An object is an instance and an instance is an object. 

Figure 7.2 shows a class named Ci rcl e and its three objects. 


instantiation 

object 

instance 


Class Name: Circle 

Data Fields: 
radius is_ 

Methods: 

getArea 

getPerimeter 

setRadius 


A class template 


Circle Object 1 

Data Fields: 
radius is 1 


Circle Object 2 

Data Fields: 
radius is 25 


Circle Object 3 

Data Fields: 
radius is 125 


Three objects of 
the Circle class 


Figure 7.2 A class is a template—or contract—for creating objects. 


7.2.1 Defining Classes 

In addition to using variables to store data fields and define methods, a class provides a special methods 
method, ni t_ . This method, known as an initializer, is invoked to initialize a new object’s initializer 
state when it is created. An initializer can perform any action, but initializers are designed to per¬ 
form initializing actions, such as creating an object’s data fields with initial values. 

Python uses the following syntax to define a class: class definition 

class ClassName: 

1 ni ti al i zer 
methods 


Listing 7.1 defines the Ci rcl e class. The class name is preceded by the keyword cl ass 

and followed by a colon ( ). The initializer is always named _i ni t _ (line 5), which is a 

special method. Note that init needs to be preceded and followed by two underscores. 
A data field radius is created in the initializer (line 6). The methods getPerimeter and 
getArea are defined to return the perimeter and area of a circle (lines 8-12). More details 
on the initializer, data fields, and methods will be explained in the following sections. 



VideoNote 

Define and use classes 


Listing 7.1 Circle.py 


1 

7 

import math 


L. 

3 

class Circle: 

class name 

4 

# Construct a circle object 


5 

def _init_(self, radius = 1): 

initializer 

6 

7 

self.radius = radius 

create data field 

/ 

8 

def getPerimeter(self): 

getPerimeterO method 

9 

return 2 * self.radius * math.pi 


10 

11 

def getArea(sel f) : 

getAreaO method 

12 

return self.radius * self.radius * math.pi 


13 

14 

def setRadius(self, radius): 


15 

self.radius = radius 
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class naming convention 


constructor 


s el f parameter 
_i nt t_method 



Note 

The naming style for class names in the Python library is not consistent. In this book, 
we will adopt a convention that capitalizes the first letter of each word in the class 
name. For example, Circle, LinearEquation, and LinkedList are correct 
class names according to our convention. 


7.2.2 Constructing Objects 

Once a class is defined, you can create objects from the class with a constructor. The con¬ 
structor does two things: 

■ It creates an object in the memory for the class. 

■ It invokes the class’s _i ni method to initialize the object. 

All methods, including the initializer, have the first parameter sel f . This parameter refers 
to the object that invokes the method. The sel f parameter in the_ i ni method is auto¬ 

matically set to reference the object that was just created. You can specify any name for this 
parameter, but by convention sel f is usually used. We will discuss the role of sel f more in 
Section 7.2.4. 

The syntax for a constructor is: 

ClassName(arguments) 

Figure 7.3 shows how an object is created and initialized. After the object is created, sel f 
can be used to reference the object. 


1. It creates an object in the memory for 

^ object 

the class. 

Data Fields: 


2. It invokes the class’s_init_method 

to initialize the object. The self 

parameter in the_init_method is 

automatically set to reference the 
object that was just created. 


_init_(self, ...) 


Figure 7.3 Constructing an object creates the object in the memory and invokes its initializer. 


The arguments of the constructor match the parameters in the _ method without 

self. For example, since the _init _ method in line 5 of Listing 7.1 is defined as 

__init_(self, radius = 1), to construct a Circle object with radius 5, you should 

use Circle (5). Figure 7.4 shows the effect of constructing a Circle object using 
CircleCS). First, a Ci rcl e object is created in the memory, and then the initializer is 
invoked to set radius to 5. 


1. Creates a Circle object. 


2. Invokes_init_(self, radius) 



Circle object 


Circle object 
radius; 5 


Figure 7.4 A circle object is constructed using Ci rcl eC5). 
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The initializer in the Circle class has a default radius value of 1. The following con¬ 
structor creates a Ci rcl e object with default radius 1: 

Ci rcle() 

7.2.3 Accessing Members of Objects 

An object’s member refers to its data fields and methods. Data fields are also called instance 
variables, because each object (instance) has a specific value for a data field. Methods are 
also called instance methods, because a method is invoked by an object (instance) to perform 
actions on the object such as changing the values in data fields for the object. In order to 
access an object’s data fields and invoke an object’s methods, you need to assign the object to 
a variable by using the following syntax: 

objectRefVar = ClassName(arguments) 

For example, 

cl = Ci rcl e(5) 
c2 = Ci rcle() 

You can access the object’s data fields and invoke its methods by using the dot operator (.), 
also known as the object member access operator. The syntax for using the dot operator is: 

objectRefVar.datafield 
objectRefVar.method(args) 

For example, the following code accesses the radius data field (line 3), and then invokes 
the getPerimeter method (line 5) and the getArea method (line 7). Note that line 1 
imports the Circle class defined in the Circle module in Listing 7.1, Circle.py. 


1 »> from Circle import Circle 

2 »> c = Ci rcle(5) 

3 »> c. radius 

4 5 

5 »> c.getPerimeterO 

6 31.41592653589793 

7 »> c.getAreaO 

8 78.53981633974483 

9 »> 



Usually you create an object and assign it to a variable. Later you can use the variable to 
reference the object Occasionally an object does not need to be referenced later. In this 
case, you can create an object without explicitly assigning it to a variable, as shown below: 

printC'Area is", Ci rcl e(5) .getAreaO) 

The statement creates a Circle object and invokes its getArea method to return its 
area. An object created in this way is known as an anonymous object. 

7.2.4 The sel f Parameter 

As mentioned earlier, the first parameter for each method defined is sel f . This parameter is 
used in the implementation of the method, but it is not used when the method is called. So, 
what is this parameter sel f for? Why does Python need it? 


default values 


instance methods 


dot operator (.) 


object member access 
operator 



anonymous object 


why sel f? 
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sel f is a parameter that references the object itself. Using sel f, you can access object’s 
members in a class definition. For example, you can use the syntax sel f. x to access the 
instance variable x and syntax self .ml() to invoke the instance method ml for the object 
sel f in a class, as illustrated in Figure 7.5. 

def ClassName: 

- 

def _init_(self, ...): 

self.x = 1 # Create/modify x 


def ml(self, ...) : 

self.y =2 # Create/modify y 

z = S # Create/modify z — 

Scope of z 

— 

def m2(self, ...): 

self.y =3 # Create/modify y 

u = self.x + 1 # Create/modify u 
self.ml(...) # Invoke ml _ 

Figure 7.5 The scope of an instance variable is the entire class. 

scope of an instance variable The scope of an instance variable is the entire class once it is created. In Figure 7.5, sel f. x 

is an instance variable created in the method. It is accessed in method m2. The 

instance variable sel f. y is set to 2 in method ml and set to 3 in m2. Note that you can also cre¬ 
ate local variables in a method. The scope of a local variable is within the method. The local 
variable z is created in method ml and its scope is from its creation to the end of method ml. 


Scope of self.x 
and self.y 


import Ci rcle 
main function 
create object 
invoke methods 

create object 


create object 


7.2.5 Example: Using Classes 

The preceding sections demonstrated the concept of class and objects. You learned how to 
define a class with the initializer, data fields, and methods, and how to create an object with 
constructor. This section presents a test program that constructs three circle objects with radii 
of 1, 25, and 125, and then displays the radius and area of each circle in Listing 7.2. The pro¬ 
gram then changes the radius of the second object to 100 and displays its new radius and area. 

Listing 7.2 TestCi rcle.py 

1 from Circle import Circle 

2 

3 def mainO : 

4 # Create a circle with radius 1 

5 circle! = CircleO 

6 print(’'The area of the circle of radius", 

7 ci rclel. radius , "is" ci rclel.getAreaO) 

8 

9 # Create a circle with radius 25 

10 circle2 = Circle(25) 

11 printC'The area of the circle of radius", 

12 ci rcl e2 . radi us , "is" ci rcl e2. getAreaO ) 

13 

14 # Create a circle with radius 125 

15 circle3 = Circle(125) 

16 printC'The area of the circle of radius", 

17 ci rcl e3. radi us , "is" ci rcl e3 . getAreaO ) 

18 
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19 # Modify circle radius 

20 circle2.radius = 100 # or circle2.setRadius(lOO) 

21 printC'The area of the circle of radius", 

22 ci rcl e2 . radi us , "is" ci rcl e2. getAreaO ) 

23 

24 mainO # Call the main function 


The 

area 

of 

the 

circle 

of 

radius 

1.0 is 3 

.141592653589793 

The 

area 

of 

the 

circle 

of 

radius 

25.0 is 

1963.4954084936207 

The 

area 

of 

the 

circle 

of 

radius 

125.0 is 

49087.385212340516 

The 

area 

of 

the 

circle 

of 

radius 

100.0 is 

31415.926535897932 


The program uses the Circle class to create Circle objects. Such a program that uses 
the class (such as Ci rcl e) is often referred to as a client of the class. 

The Ci rcl e class is defined in Listing 7.1, Circle.py, and this program imports it in line 1 
using the syntax from Circle import Circle. The program creates a Circle object 
with a default radius 1 (line 5) and creates two Ci rcl e objects with the specified radii (lines 
10, 15), and then retrieves the radius property and invokes the getAreaC) method on the 
objects to obtain the area (lines 7, 12, and 17). The program sets a new radius property on 
circleZ (line 20). This can also be done by using circleZ. setRadi us (100). 

Note 

An variable that appears to hold an object actually contains a reference to that object. 

Strictly speaking, a variable and an object are different, but most of the time the distinction 
can be ignored. So it is fine, for simplicity, to say that “circlel is a Circle object” 
rather than use the longer-winded description that “ci rcl el is a variable that contains a 
reference to a Ci rcl e object.” 

7.1 Describe the relationship between an object and its defining class. 

7.2 How do you define a class? 

7.3 How do you create an object? 

7.4 What is the name of the initializer method? 

7.5 The first parameter in the initializer method is named sel f by convention. What is 
the role of sel f ? 

7.6 What is the syntax for constructing an object? What does Python do when construct¬ 
ing an object? 

7.7 What are the differences between an initializer and a method? 

7.8 What is the object member access operator for? 

7.9 What problem arises in running the following program? How do you fix it? 

class A: 

def _init_(self, i): 

self.i = i 

def mai n() : 
a = A() 
print(a.i) 

mainO # Call the main function 
7.10 What is wrong with the following programs? 



set a new radius 



client 


object vs. variable 


iCheck 

Point 

MyProgrammingLab" 
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1 class A: 

2 # Construct an object of the class 

3 def A(self): 

4 radius = 3 


1 class A: 

2 # Construct an object of the class 

3 def _init_(self): 

4 radius = 3 

5 

6 def setRadius(radius): 

7 self.radius = radius 


(a) 


(b) 


UML 


7.3 UML Class Diagrams 

dataFieldName: dataFieldType 
Constructors are shown as: 

ClassNameCparameterName: parameterType) 

Methods are represented as: 

methodName(parameterName: parameterType); returnType 

UML Class Diagram Circle 

radius: float 

Ci rcle(radius = 1: float) 
getAreaO : float 
getPerimeterO : float 
setRadius(radius: float): None 


Class name 

Data fields 

Constructor 

Methods 


UML class diagrams use graphical notation to describe classes. 

The illustration of class templates and objects in Figure 7.2 can be standardized using UML (Uni¬ 
fied Modeling Language) notation. This notation, as shown in Figure 7.6, called a UML class dia¬ 
gram or simply a class diagram, is language independent; that is, other programming languages 
use this same modeling and notation. In UML class diagrams, data fields are denoted as: 


circlel: Circle 

circle2: Circle 

circle3: Circle 

radius = 1 

radius = 25 

radius = 125 


UML notation 
for objects 


Figure 7.6 Classes and objects can be represented using UML notation. 

The method definition in the class always has the special sel f parameter, but don’t 
include it in the UML diagram, because the client does not need to know this parameter and 
does not use this parameter to invoke the methods. 

The ni t_ method does not need to be listed in the UML diagram either, because it is 
invoked by the constructor and its parameters are the same as the constructor’s parameters. 

The UML diagram serves as the contract (template) for the client so that it will know how to 
use the class. The diagram describes for the client how to create objects and how to invoke the 
methods on the objects. 

As an example, consider TV sets. Each TV is an object with states (that is, current chan¬ 
nel, current volume level, and power on or off are its properties that are represented by data 
fields) and behaviors (change channels, adjust volume, and turn on/off are the actions each 
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TV object implements with methods). You can use a class to define TV sets. The UML dia¬ 
gram for the TV class is shown in Figure 7.7. 



The current channel (1 to 120) of this TV. 
The current volume level (1 to 7) of this TV. 
Indicates whether this TV is on/off. 

Constructs a default TV object. 

Turns on this TV. 

Turns off this TV. 

Returns the channel for this TV. 

Sets a new channel for this TV. 

Gets the volume level for this TV. 

Sets a new volume level for this TV. 
Increases the channel number by 1. 
Decreases the channel number by 1. 
Increases the volume level by 1. 

Decreases the volume level by 1. 


Figure 7.7 The TV class defines TV sets. 


for defining the TV class. 


Listing 7.3 gives the Python code 

Listing 7.3 TV.py 

1 class TV: 

2 def init (self): 

3 self.channel = 1 

4 self.volumeLevel 

5 self.on = False 

6 

7 def turnOn(self): 

8 self.on = True 

9 

10 
11 
12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 


# Default channel is 1 

= 1 # Default volume level is 1 

# Initially, TV is off 


def turnOff(self) : 
self.on = False 

def getChannel(self): 
return self.channel 

def setChannel(self, channel): 

if self.on and 1 <= self.channel <= 120: 
self.channel = channel 

def getVolumeLevel(self): 
return self.volumeLevel 

def setVolume(self, volumeLevel): 
if self.on and \ 

1 <= self.volumeLevel <= 7: 
self.volumeLevel = volumeLevel 

def channelUp(self): 


define a class 
define initializer 
create instance variables 

turn on TV 

turn off TV 

get the channel 

set a new channel 

get the volume 

set a new volume 

increase channel 
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decrease channel 


increase volume 


decrease volume 


import TV class 

mat n function 
create a TV 
turn on 

set a new channel 
set a new volume 

create a TV 
turn on 

increase channel 
increase volume 
display state 


29 if self.on and self.channel < 120: 

30 self.channel += 1 

31 

32 def channelDown(self): 

33 if self.on and self.channel > 1: 

34 self.channel -= 1 

35 

36 def volumeUpCself): 

37 if self.on and self.volumeLevel < 7: 

38 self.volumeLevel += 1 

39 

40 def volumeDown(self): 

41 if self.on and self.volumeLevel > 1: 

42 self.volumeLevel -= 1 

The initializer creates the instance variables channel , vol umeLevel , and on for the data 
fields in a TV object (lines 2-5). Note that this initializer does not have any argument except 

sel f. 

The channel and volume level are not changed if the TV is not on (lines 16-18 and 23-26). 
Before either of these is changed, its current value is checked to ensure that it is within the 
correct range. 

Listing 7.4 is a program that uses the TV class to create two objects. 

Listing 7.4 TestTV.py 

1 from TV import TV 

2 

3 def mainO : 

4 tvl = TV() 

5 tvl.turnOnO 

6 tvl.setChannel (30) 

7 tvl.setVolumeCS) 

8 

9 tv2 = TV() 

10 tv2.turn0n() 

11 tv2. channel UpO 

12 tv2. channel UpO 

13 tv2.volumeUpO 

14 

15 printC'tvl's channel is", tvl.getChannel () , 

16 "and volume level is", tvl.getVolumeLevel() ) 

17 print("tv2's channel is", tv2.getChannel(), 

18 "and volume level is", tv2.getVolumeLevel()) 

19 

20 mainO # Call the main function 



tvl's channel is 30 and volume level is 3 
tv2's channel is 3 and volume level is 2 


The program creates two TV objects tvl and tv2 (lines 4 and 9), and invokes the methods 
on the objects to perform actions for setting channels and volume levels and for increasing 
channels and volumes, tvl is turned on by invoking tvl. turnOnC) in line 5, its channel is 
set to 30 by invoking tvl. setChannel (30) in line 6, and its volume level is set to 3 in line 
7. tv2 is turned on in line 10, its channel is increased by 1 by invoking tv2. channel Up() 
in line 11, and again by another 1 in line 12. Since the initial channel is set to 1 (line 3 in 
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TV.py), tv2’s channel is now 3. tv2’s volume is increased by 1 by invoking 
tv2 . vol umeUpC) in line 13. Since the initial volume is set to 1 (line 4 in TV.py), tv2’s vol¬ 
ume is now 2. 

The program displays the state of the objects in lines 15-18. The data fields are read using 

the getChannel () and getVol umeLevel () methods. 


7.4 Immutable Objects vs. Mutable Objects 

When passing a mutable object to a function, the function may change the contents of 
the object. 


^/Key 
) Point 


Recall that numbers and strings are immutable objects in Python. Their contents cannot be 
changed. When passing an immutable object to a function, the object will not be changed. 
However, if you pass a mutable object to a function, the contents of the object may change. 
The example in Listing 7.5 demonstrates the differences between an immutable object and 
mutable object arguments in a function. 


Listing 7.5 TestPassMutableObject.py 


1 

7 

from Circle import Circle 

import Ci rcle 

L. 

3 

def mainO : 


4 

# Create a Circle object with radius 1 


5 

c 

myCircle = CircleO 

create object 

o 

7 

# Print areas for radius 1, 2, 3, 4, and 5 


8 

n = 5 


9 

10 

printAreas(myCircle, n) 

invoke pri ntAreas 

11 

# Display myCircle.radius and times 


12 

pri nt("\nRadius is", myCircle.radius) 

display radius 

13 

14 

printC'n is", n) 

display n 

15 

# Print a table of areas for radius 


16 

def printAreas(c, times): 


17 

printC'Radius \t\tArea") 


18 

while times >= 1: 


19 

pri nt(c. radi us, "\t\t", c.getAreaO) 


20 

c.radius = c.radius + 1 


21 

22 

times = times - 1 


23 

mainO # Call the main function 



Radi us 

Area 

1 

3.141592653589793 

2 

12.566370614359172 

3 

29.274333882308138 

4 

50.26548245743669 

5 

79.53981633974483 

Radius is 6 


n i s 5 




The Circle class is defined in Listing 7.1. The program passes a Circle object 
myCircle and an int object n to invoke printAreas(ttiyCircle, n) (line 9), which 
prints a table of areas for radii 1, 2, 3, 4, and 5, as shown in the sample output. 
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immutable object vs. mutable 
object 


iCheck 
W Point 

MyProgrammingLab" 


When you pass an object to a function, the reference of the object is passed to the function. 
However, there are important differences between passing immutable objects and mutable 
objects. 

■ For an argument of an immutable object such as a number or string, the original 
value of the object outside the function is not changed. 

■ For an argument of a mutable object such as a circle, the original value of the object 
is changed if the contents of the object are changed inside the function. 

In line 20, the radius property of the Ci rcl e object c is incremented by 1. c. radius 
+ 1 creates a new int object, which is assigned to c. radius. myCi rcle and c both point to 
the same object. When the printAreas function is finished, c. radius is 6. So, the printout 

for myCi rcle. radius is 6 from line 12. 

In line 21, times - 1 creates a new int object, which is assigned to times. Outside of 
the pri ntAreas function, n is still 5. So, the printout for n is 5 from line 13. 


7.1 I Show the output of the following program: 

class Count: 

def _init_(self, count = 0) : 

self.count = count 

def main(): 

c = CountO 
times = 0 

for i in range(lOO): 
incrementfc, times) 

printC'count is", c.count) 
printC'times is", times) 

def increment(c, times): 
c.count += 1 
times += 1 

mainO # Call the main function 


7.12 Show the output of the following program: 

class Count: 

def _init_(self, count = 0) : 

self.count = count 

def main(): 

c = CountO 
n = 1 
m(c, n) 

printC'count is", c.count) 
printC'n is", n) 

def m(c, n) : 

c = Count(5) 
n = 3 


mainO # Call the main function 
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7.5 Hiding Data Fields 

Making data fields private protects data and makes the class easy to maintain. 

You can access data fields via instance variables directly from an object. For example, the fol¬ 
lowing code, which lets you access the circle’s radius from c. radius, is legal: 


»> c = Ci rcle(5) 

»> c. radius = 5.4 # Access instance variable directly 
»> print(c. radius) # Access instance variable directly 
5.4 
»> 


However, direct access of a data field in an object is not a good practice—for two reasons: 

■ First, data may be tampered with. For example, channel in the TV class has a value 
between 1 and 120 , but it may be mistakenly set to an arbitrary value (e.g., 

tvl.channel = 125). 

■ Second, the class becomes difficult to maintain and vulnerable to bugs. Suppose you 
want to modify the Ci rcl e class to ensure that the radius is nonnegative after other 
programs have already used the class. You have to change not only the Ci rcl e class 
but also the programs that use it, because the clients may have modified the radius 
directly (e.g., myCi rcl e. radi us = -5). 

To prevent direct modifications of data fields, don’t let the client directly access data fields. 
This is known as data hiding. This can be done by defining private data fields. In Python, the 
private data fields are defined with two leading underscores. You can also define a private 
method named with two leading underscores. 

Private data fields and methods can be accessed within a class, but they cannot be accessed 
outside the class. To make a data field accessible for the client, provide a get method to return 
its value. To enable a data field to be modified, provide a set method to set a new value. 

Colloquially, a get method is referred to as a getter (or accessor), and a set method is 
referred to as a setter (or mutator). 

A get method has the following header: 

def getPropertyA/ame(sel f) : 

If the return type is Boolean, the get method is defined as follows by convention: 
def isPropertyNameiself): 

A set method has the following header: 

def setPropertyNameQself, propertyValue): 

Listing 7.6 revises the Ci rcl e class in Listing 7. 1 by defining the radius property as pri¬ 
vate by placing two underscores in front of the property name (line 6). 

Listing 7.6 Ci rcleWi thPrivateRadius.py 

1 import math 

2 

3 class Circle: 

4 # Construct a circle object 

5 def _ init_(self, radius = 1): 

6 self._radius = radius 

7 





VideoNote 

Private data fields 


data hiding 
private data fields 
private method 


accessor 

mutator 


Boolean accessor 


class name 

initializer 
private radius 
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getRadius() 


8 

def 

getRadius(self): 

9 


return self._radius 

10 

11 

def 

getPerimeter(self): 

12 


return 2 * self._radius * math.pi 

13 

14 

def 

getArea(self): 

15 


return self._radius * self._radius 


The radius property cannot be directly accessed in this new Ci rcle class. However, you 
can read it by using the getRadi us C) method. For example: 


1 

»> from CircleWithPrivateRadius 

import Circle 

2 

»> c = Ci rcle(5) 


3 

»> c._radius 


4 

AttributeError: no attribute '_ 

radius' 

5 

»> c. getRadi us 0 


6 

5 


7 

»> 




Line 1 imports the Circle class, which is defined in the CircleWithPrivateRadius 
module in Listing 7.6. Line 2 creates a Ci rcl e object. Line 3 attempts to access the property 

_radius. This causes an error, because _radius is private. However, you can use the 

getRadi us C) method to return the radius (line 5). 

Tip 

If a class is designed for other programs to use, to prevent data from being tampered with 
and to make the class easy to maintain, define data fields as private. If a class is only 
used internally by your own program, there is no need to hide the data fields. 




Note 

Name private data fields and methods with two leading underscores, but don't end the 
name with more than one underscores. The names with two leading underscores and 

two ending underscores have special meaning in Python. For example_ radius is a 

private data field, but_ radius _ is not a private data field. 
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What problem arises in running the following program? How do you fix it? 

class A: 

def _ _init_(self, i): 

self._i = i 


def mai n(): 
a = A(5) 
print(a._i) 

mainO # Call the main function 


Is the following code correct? If so, what is the printout? 

1 def mai n() : 

2 a = A() 

3 a.printO 

4 


7.14 
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5 class A: 

6 def _init_(self, newS = "Welcome"): 

7 self. s = news 

8 

9 def print(self): 

10 print(self. s) 

11 

12 mainO # Call the main function 

7.15 Is the following code correct? If not, fix the error. 

class A: 

def _init_(self, on): 

self._on = not on 

def mai n() : 

a = A(False) 
print(a.on) 

mainO # Call the main function 

7.16 What are the benefits of data hiding? How is it done in Python? 

7.17 How do you define a private method? 

7.6 Class Abstraction and Encapsulation 

Class abstraction is a concept that separates class implementation from the use of a 
class. The class implementation details are invisible from the user. This is known as 
class encapsulation. 

There are many levels of abstraction in software development. In Chapter 6, you learned 
about function abstraction and used it in stepwise refinement. Class abstraction is the separa¬ 
tion of class implementation from the use of a class. The creator of a class describes the 
class’s functions and lets the client know how the class can be used. The class’s collection of 
methods, together with the description of how these methods are expected to behave, serves 
as the class’s contract with the client. 

As shown in Figure 7.8, the user of the class does not need to know how the class is 
implemented. The details of implementation are encapsulated and hidden from the user. This 
is known as class encapsulation. In essence, encapsulation combines data and methods into 
a single object and hides the data fields and method implementation from the user. For exam¬ 
ple, you can create a Ci rcl e object and find the area of the circle without knowing how the 
area is computed. For this reason, a class is also known as an abstract data type (ADT). 


Class implementation 
is like a black box 
hidden from the clients 



Class’s Contract 

Class 

(headers of 
initializer and 


methods) 


Clients use the 
class through the 
class’s contract 


Figure 7.8 Class abstraction separates class implementation from the use of the class. 

Class abstraction and encapsulation are two sides of the same coin. Many real-life exam¬ 
ples illustrate the concept of class abstraction. Consider, for instance, building a computer 
system. Your personal computer has many components—a CPU, memory, disk, motherboard, 
fan, and so on. Each component can be viewed as an object that has properties and methods. 
To get the components to work together, you need to know only how each component is used 
and how it interacts with the others. You don’t need to know how the components work 
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internally. The internal implementation is encapsulated and hidden from you. You can even 
build a computer without knowing how a component is implemented. 

The computer-system analogy precisely mirrors the object-oriented approach. Each com¬ 
ponent can be viewed as an object of the class for the component. For example, you might 
have a class that defines fans for use in a computer, with properties such as fan size and speed 
and methods such as start and stop. A specific fan is an instance of this class with specific 
property values. 

As another example, consider getting a loan. A specific loan can be viewed as an object of 
a Loan class. The interest rate, loan amount, and loan period are its data properties, and com¬ 
puting monthly payment and total payment are its methods. When you buy a car, a loan object 
is created by instantiating the class with your loan interest rate, loan amount, and loan period. 
You can then use the methods to find the monthly payment and total payment of your loan. As 
a user of the Loan class, you don’t need to know how these methods are implemented. 

Listing 2.8, ComputeLoan.py, presented a program for computing loan payments. The 
program as it is currently written cannot be reused in other programs. One way to fix this 
problem is to define functions for computing monthly payment and total payment. However, 
this solution has limitations. Suppose you wish to associate a borrower with the loan. There is 
no good way to tie a borrower with a loan without using objects. The traditional procedural 
programming paradigm is action-driven; data are separated from actions. The object-oriented 
programming paradigm focuses on objects, so actions are defined along with the data in 
objects. To tie a borrower with a loan, you can define a loan class with borrower along with 
other properties of the loan as data fields. A loan object would then contain data and actions 
for manipulating and processing data, with loan data and actions integrated in one object. 
Figure 7.9 shows the UML class diagram for the Loan class. Note that the (dash) in the 
UML class diagram denotes a private data field or method of the class. 



The — sign denotes a private data fiek 



-numberOfYears: int 
-loanAmount: float 
-borrower: str 


The annual interest rate of the loan (default 2.5). 
The number of years for the loan (default 1). 

The loan amount (default 1000). 

The borrower of this loan (default " ”). 


float, borrower: str) 
getAnnualInterestRateO: float 
getNumberOfYearsC): int 
getLoanAmountO : float 
getBorrowerO: str 
setAnnua1InterestRate( 


Loan(annualInterestRate: float, 


numberOfYears: int,loanAmount 


Constructs a Loan object with the 
specified annual interest rate, number of years, loan 
amount, and borrower. 

Returns the annual interest rate of this loan. 

Returns the number of the years of this loan. 

Returns the amount of this loan. 

Returns the borrower of this loan. 

Sets a new annual interest rate for this loan. 


annualInterestRate: float): None 
setNumberOfYears( 


Sets a new number of years for this loan. 


numberOfYears: int): None 
setLoanAmountC 


Sets a new amount for this loan. 


loanAmount: float): None 
setBorrower(borrower: str): None 
setMonthlyPaymentO : float 
getTotalPayment0: float 


Sets a new borrower for this loan. 

Returns the monthly payment of this loan. 
Returns the total payment of this loan. 


Figure 7.9 The UML diagram for the Loan class models (shows) the properties and behaviors of loans. 
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The UML diagram in Figure 7.9 serves as the contract for the Loan class. That is, the user 
can use the class without knowing how the class is implemented. Assume that the Loan class 
is available. We begin by writing a test program that uses the Loan class in Listing 7.7. 

Listing 7.7 TestLoanCl ass. py 

1 from Loan import Loan 

2 

3 def mainO : 

4 # Enter yearly interest rate 

5 annualInterestRate = eval(input 

6 ("Enter yearly interest rate, for example, 7.25: ")) 

7 

8 # Enter number of years 

9 numberOfYears = eval(input( 

10 "Enter number of years as an integer: ")) 

11 

12 # Enter loan amount 

13 loanAmount = eval(input( 

14 "Enter loan amount, for example, 120000.95: ")) 

15 

16 # Enter a borrower 

17 borrower = input("Enter a borrower's name: ") 

18 

19 # Create a Loan object 

20 loan = Loan(annualInterestRate, numberOfYears, create Loan object 

21 loanAmount, borrower) 

22 

23 # Display loan date, monthly payment, and total payment 

24 printC'The loan is for", loan.getBorrowerO ) invoke instance method 

25 printC'The monthly payment is", 

26 format(loan.getMonthlyPayment() , ".2f")) invoke instance method 

27 printC'The total payment is", 

28 format(loan. getTotal PaymentO , ".2f")) invoke instance method 

29 

30 mainO # Call the main function 


Enter yearly interest rate, for example , 7.2 5: 2.5 baiter | 

Enter number of years as an integer: 5 1 _ 

Enter loan amount, for example, 1200 00.95 : 1000 I^TnteTj 
Enter a borrower's name: John Jones enter| 

The loan is for John Jones 
The monthly payment is 17.75 
The total payment is 1064.84 



The main function (1) reads the interest rate, payment period (in years), and loan amount, 

(2) creates a Loan object, and then (3) obtains the monthly payment (line 26) and total pay¬ 
ment (line 28) using the instance methods in the Loan class. 

The Loan class can be implemented as in Listing 7.8. 

Listing 7.8 Loan. py 

1 class Loan : 

2 def _init_(self, annual InterestRate = 2.5, initializer 

3 numberOfYears = 1, loanAmount = 1000, borrower = ): 

4 self._annualInterestRate = annualInterestRate 

5 self._numberOfYears = numberOfYears 

6 self._loanAmount = loanAmount 
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get methods 


set methods 


getMonthlyPayment 


getTotalPayment 


7 self._borrower = borrower 

8 

9 def getAnnualInterestRate(self): 

10 return self._annualInterestRate 

11 

12 def getNumberOfYears(self): 

13 return self._numberOfYears 

14 

15 def getLoanAmount(self): 

16 return self._loanAmount 

17 

18 def getBorrower(self): 

19 return self._borrower 

20 

21 def setAnnualInterestRate(self, annualInterestRate): 

22 self._annualInterestRate = annualInterestRate 

23 

24 def setNumberOfYears(self, numberOfYears): 

25 self._numberOfYears = numberOfYears 

26 

27 def setLoanAmount(self, loanAmount): 

28 self._loanAmount = loanAmount 

29 

30 def setBorrower(self, borrower): 

31 self._borrower = borrower 

32 

33 def getMonthlyPayment(self): 

34 monthlyInterestRate = self._annualInterestRate / 1200 

35 monthlyPayment = \ 

36 self._loanAmount * monthlyInterestRate / (1 - (1 / 

37 (1 + monthlyInterestRate) ** (self._numberOfYears * 12))) 

38 return monthlyPayment 

39 

40 def getTotalPayment(self): 

41 totalPayment = self.getMonthlyPaymentO * \ 

42 self._numberOfYears * 12 

43 return totalPayment 

Because the data fields annual InterestRate, numberOfYears, loanAmount, and 
borrower are defined as private (with two leading underscores), they cannot be accessed 
from outside the class by a client program. 

From a class developer’s perspective, a class is designed for use by many different cus¬ 
tomers. In order to be useful in a wide range of applications, a class should provide a variety 
of ways for users to customize the class with methods. 

Important Pedagogical Tip 

The UML diagram for the Loan class is shown in Figure 7.9. You should first write a test 
program that uses the Loan class even though you don’t know how the Loan class is 
implemented. This has three benefits: 

■ It demonstrates that developing a class and using a class are two separate 
tasks. 

■ It enables you to skip the complex implementation of certain classes without 
interrupting the sequence of the book. 

■ It is easier to learn how to implement a class if you are familiar with the 
class through using it. 

For all the class development examples from now on, first create an object from the class 
and try to use its methods and then turn your attention to its implementation. 
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7.7 Object-Oriented Thinking 

The procedural paradigm for programming focuses on designing functions. The 
object-oriented paradigm couples data and methods together into objects. Software 
design using the object-oriented paradigm focuses on objects and operations on 
objects. 

This book’s approach is to teach problem solving and fundamental programming techniques 
before object-oriented programming. This section shows how procedural and object-oriented 
programming differ. You will see the benefits of object-oriented programming and learn to 
use it effectively. We will improve the solution for the BMI problem introduced in Chapter 4 
by using the object-oriented approach. From the improvements, you will gain insight into the 
differences between procedural and object-oriented programming and see the benefits of 
developing reusable code using objects and classes. 

Listing 4.6, ComputeBMI.py, presents a program for computing body mass index. The 
code as it is cannot be reused in other programs. To make it reusable, define a standalone 
function to compute body mass index, as follows: 

def getBMI(weight, height): 

This function is useful for computing body mass index for a specified weight and height. 
However, it has limitations. Suppose you need to associate the weight and height with a per¬ 
son’s name and birth date. You could create separate variables to store these values, but these 
values are not tightly coupled. The ideal way to couple them is to create an object that con¬ 
tains them. Since these values are tied to individual objects, they should be stored in data 
fields. You can define a class named BMI, as shown in Figure 7.10. 




Key 

Point 


BMI 


-name: str 
-age: int 
-weight: float 
-height: float 


BMI(name: str, age: int, weight: 
float, height: float) 

getBMIC): float 
getStatusC): str 


The get methods for these data fields 
are provided in the class, but are omitted in 
the UML diagram for brevity. 


The name of the person. 

The age of the person. 

The weight of the person in pounds. 
The height of the person in inches. 

Creates a BMI object with the specified 
name, age (the default is 20), weight, 
and height. 

Returns the BMI. 

Returns the BMI status (e.g.. Normal, 
Overweight, etc.). 


Figure 7.10 The BMI class encapsulates BMI data and methods. 


Assume that the BMI class is available. Listing 7.9 is a test program that uses this class. 

Listing 7.9 UseBMICl ass. py 

1 from BMI import BMI import BMI class 

2 

3 def mai n () : 

4 bmil = BMK'Iohn Doc", 18, 145, 70) 

5 printC'The BMI for", bmil.getNameO , "is"_ 


create an object 
invoke method 
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create an object 
invoke method 


6 bmil.getBMIO , bmi 1.getStatusO ) 

7 

8 bmi2 = BMI (Peter King", 50, 215, 70) 

9 printC'The BMI for", bmi 2 .getNameO , ''is"_ 

10 bmi2 .getBMIO , bmi2 .getStatusO) 

11 

12 mainO # Call the main function 



The BMI for John Doe is 20.81 Normal 
The BMI for Peter King is 30.85 Obese 


Line 4 creates an object bmi 1 for John Doe and line 8 creates an object bmi 2 for Peter 
King. You can use the methods getNameC), getBMIO, and getStatusO to return the 
BMI information in a BMI object (lines 5 and 9). 

The BMI class can be implemented as in Listing 7.10. 


initializer 


getBMI 


getStatus 


Listing 7.10 BMI.py 


2 

def 

_init_(self, name, age, weight, height): 

3 


self._name = name 

4 


self._age = age 

5 


self._weight = weight 

6 

7 


self._height = height 

8 

def getBMI(self): 

9 


KIL0GRAMS_PER_P0UND = 0.45359237 

10 


METERS_PER_INCH = 0.0254 

11 


bmi = self._weight * KIL0GRAMS_PER_P0UND 

12 


((self._height * METERS_PER_INCH) * \ 

13 


(self._height * METERS_PER_INCH)) 

14 


return round(bmi * 100) / 100 

15 



16 

def 

getStatus(self): 

17 


bmi = self .getBMIO 

18 


if bmi < 18.5: 

19 


return "Underweight" 

20 


el if bmi < 25: 

21 


return "Normal" 

22 


elif bmi < 30: 

23 


return "Overweight" 

24 


el se : 

25 


return "Obese" 

26 



27 

def 

getName(self): 

28 


return self._name 

29 



30 

def 

getAge(self): 

31 


return self._age 

32 



33 

def 

getWeight(self): 

34 


return self._weight 

35 



36 

def 

getHeight(self): 

37 


return self._height 
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The mathematical formula for computing the BMI using weight and height is given in 
Section 4.9. The method getBMIC) returns the BMI. Since the weight and height are data 
fields in the object, the getBMIC) method can use these properties to compute the BMI for 
the object. 

The method getStatusO returns a string that interprets the BMI. The interpretation is 
also given in Section 4.9. 

This example demonstrates the advantages of the object-oriented paradigm over the proce- procedural vs. object-oriented 
dural paradigm. The object-oriented approach combines the power of the procedural para- paradigms 
digm with an added dimension that integrates data with operations into objects. 

In procedural programming, data and operations are separate, and this methodology 
requires sending data to methods. Object-oriented programming places data and the opera¬ 
tions that pertain to them together in an object. This approach solves many of the problems 
inherent in procedural programming. The object-oriented programming approach organizes 
programs in a way that mirrors the real world, in which all objects are associated with both 
attributes and activities. Using objects improves software reusability and makes programs 
easier to develop and easier to maintain. Programming in Python involves thinking in terms of 
objects; a Python program can be viewed as a collection of cooperating objects. 

7.18 Describe the differences between procedural and object-oriented paradigms. JT 

^ Point 
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abstract data type (ADT) 229 

identity 216 

accessor (getter) 227 

initializer 217 
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anonymous object 219 
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class abstraction 229 
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state 216 

data hiding 227 
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dot operator (.) 219 

(UML) 222 

Chapter Summary 



i. A class is a template, a blueprint, a contract, and a data type for objects. It defines the 
properties of objects and provides an initializer for initializing objects and methods 
for manipulating them. 


2. The initializer is always named _init _ . The first parameter in each method 

including the initializer in the class refers to the object that calls the method. By con¬ 
vention, this parameter is named sel f . 

3. An object is an instance of a class. You use the constructor to create an object, and 
the dot operator ( ) to access members of that object through its reference variable. 
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4* An instance variable or method belongs to an instance of a class. Its use is associated 
with individual instances. 

5. Data fields in classes should be hidden to prevent data tampering and to make classes 
easy to maintain. 

6. You can provide a get method or a set method to enable clients to see or modify the 
data. Colloquially, a get method is referred to as a getter (or accessor), and a set 
method as a setter (or mutator). 


Test Questions 

Do test questions for this chapter online at www.cs.armstrong.edu/liang/py/test.html. 
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Sections 7.2-7.3 

7.1 {The Rectangle class) Following the example of the Ci rcl e class in Section 
7.2, design a class named Rectangle to represent a rectangle. The class 
contains: 

■ Two data fields named width and height. 

■ A constructor that creates a rectangle with the specified width and height. 
The default values are 1 and 2 for the width and height, respectively. 

■ A method named getAreaC) that returns the area of this rectangle. 

■ A method named getPerimeter () that returns the perimeter. 

Draw the UML diagram for the class, and then implement the class. Write a test 
program that creates two Rectangl e objects—one with width 4 and height 40 
and the other with width 3 . 5 and height 35.7. Display the width, height, area, 
and perimeter of each rectangle in this order. 

Sections 7.4-7.7 

7.2 {The Stock class) Design a class named Stock to represent a company’s stock 
that contains: 

■ A private string data field named symbol for the stock’s symbol. 

■ A private string data field named name for the stock’s name. 

■ A private float data field named previousCl osi ngPri ce that stores the stock 
price for the previous day. 

■ A private float data field named currentPrice that stores the stock price for 
the current time. 

■ A constructor that creates a stock with the specified symbol, name, previous 
price, and current price. 

■ A get method for returning the stock name. 

■ A get method for returning the stock symbol. 

■ Get and set methods for getting/setting the stock’s previous price. 

■ Get and set methods for getting/setting the stock’s current price. 

■ A method named getChangePercentC) that returns the percentage changed 
from previousClosingPrice to currentPrice. 

Draw the UML diagram for the class, and then implement the class. Write a test 
program that creates a Stock object with the stock symbol INTC, the name Intel 
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Corporation, the previous closing price of 20.5, and the new current price of 
20.35, and display the price-change percentage. 

7.3 {The Account class) Design a class named Account that contains: 

■ A private 1 nt data field named id for the account. 

■ A private float data field named bal ance for the account. 

■ A private float data field named annual InterestRate that stores the current 
interest rate. 

■ A constructor that creates an account with the specified id (default 0), initial 
balance (default 100), and annual interest rate (default 0). 

■ The accessor and mutator methods for i d, bal ance, and annual InterestRate. 

■ A method named getMonthlylnterestRateC) that returns the monthly 
interest rate. 

■ A method named getMonthlylnterestC) that returns the monthly interest. 

■ A method named withdraw that withdraws a specified amount from the 
account. 

■ A method named deposit that deposits a specified amount to the account. 

Draw the UML diagram for the class, and then implement the class. (Hint: The 
method getMonthlylnterestC) is to return the monthly interest amount, not 
the interest rate. Use this formula to calculate the monthly interest: bal ance * 
monthlyInterestRate. monthlyInterestRate is annualInterestRate 
/ 12. Note that annual InterestRate is a percent (like 4.5%). You need to 
divide it by 100 .) 

Write a test program that creates an Account object with an account id of 1122, a 
balance of $20,000, and an annual interest rate of 4.5%. Use the withdraw 
method to withdraw $2,500, use the deposit method to deposit $3,000, and print 
the id, balance, monthly interest rate, and monthly interest. 

7.4 {The Fan class) Design a class named Fan to represent a fan. The class contains: 

■ Three constants named SLOW, MEDIUM, and FAST with the values 1, 2, and 3 to 
denote the fan speed. 

■ A private i nt data field named speed that specifies the speed of the fan. 

■ A private bool data field named on that specifies whether the fan is on (the 
default is Fal se). 

■ A private float data field named radius that specifies the radius of the fan. 

■ A private string data field named col or that specifies the color of the fan. 

■ The accessor and mutator methods for all four data fields. 

■ A constructor that creates a fan with the specified speed (default SLOW), radius 
(default 5), color (default bl ue), and on (default Fal se). 

Draw the UML diagram for the class and then implement the class. Write a test 
program that creates two Fan objects. For the first object, assign the maximum 
speed, radius 10, color yellow, and turn it on. Assign medium speed, radius 5, 
color bl ue, and turn it off for the second object. Display each object’s speed, 
radius, color, and on properties. 

*7.5 {Geometry: n-sided regular polygon) An n-sided regular polygon’s sides all have 
the same length and all of its angles have the same degree (i.e., the polygon is 
both equilateral and equiangular). Design a class named RegularPolygon that 
contains: 

■ A private i nt data field named n that defines the number of sides in the polygon. 

■ A private float data field named side that stores the length of the side. 

■ A private float data field named x that defines the x-coordinate of the center of 
the polygon with default value 0. 
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■ A private float data field named y that defines the y-coordinate of the center of 
the polygon with default value 0. 

■ A constructor that creates a regular polygon with the specified n (default 3), 
side (default 1), x (default 0), and y (default 0). 

■ The accessor and mutator methods for all data fields. 

■ The method getPerimeterC) that returns the perimeter of the polygon. 

■ The method getAreaC) that returns the area of the polygon. The formula for 

n X 

computing the area of a regular polygon is Area = - 

4 X tan 

Draw the UML diagram for the class, and then implement the class. Write a test pro¬ 
gram that creates three Regu1 arPol ygon objects, created using Regul arPol ygon () , 
using Regul arPol ygon (6, 4) and Regul arPol ygon (10, 4, 5.6, 7.8). For 
each object, display its perimeter and area. 



*7.6 


{Algebra: quadratic equations) Design a class named QuadraticEquatfon for a 
quadratic equation ax^ + bx + x = Q. The class contains; 

■ The private data fields a, b, and c that represent three coefficients. 

■ A constructor for the arguments for a, b, and c. 

■ Three get methods for a, b, and c. 

■ A method named getDi scrimi nant () that returns the discriminant, which is 
b^ — Aac. 

■ The methods named getRoot 1 () and getRootZ () for returning the two roots 
of the equation using these formulas: 


—b \/b^ — Aac 

r-i = - and 

^ 2a 


D = 


-b - Vb^ - Aac 
2a 


These methods are useful only if the discriminant is nonnegative. Let these meth¬ 
ods return 0 if the discriminant is negative. 

Draw the UML diagram for the class, and then implement the class. Write a test 
program that prompts the user to enter values for a, b, and c and displays the result 
based on the discriminant. If the discriminant is positive, display the two roots. If 
the discriminant is 0, display the one root. Otherwise, display “The equation has 
no roots.” See Exercise 4.1 for sample runs. 

*7.7 {Algebra: 2X2 linear equations) Design a class named LinearEquation for a 
2X2 system of linear equations: 


ax + by = e ed — bf of — ec 

X = - y = - 

cx + dy = f ad — be ad — be 

The class contains: 

■ The private data fields a, b, c, d, e, and f with get methods. 

■ A constructor with the arguments for a, b, c, d, e, and f . 

■ Six get methods for a, b, c, d, e, and f. 

■ A method named i sSol vabl e() that returns true if ad — be is not 0. 

■ The methods getXC) and getY() that return the solution for the equation. 

Draw the UML diagram for the class, and then implement the class. Write a test 
program that prompts the user to enter a, b, c, d, e, and f and displays the result. 
If ad — be is 0, report that “The equation has no solution.” See Exercise 4.3 for 
sample runs. 









Programming Exercises 239 


*7.8 (Stopwatch) Design a class named StopWatch. The class contains: 

■ The private data fields startTime and endTime with get methods. 

■ A constructor that initializes startTime with the current time. 

■ A method named start () that resets the startTime to the current time. 

■ A method named stopO that sets the endTime to the current time. 

■ A method named getE1apsedTime() that returns the elapsed time for the 
stop watch in milliseconds. 

Draw the UML diagram for the class, and then implement the class. Write a test 
program that measures the execution time of adding numbers from 1 to 
1 , 000 , 000 . 

**7.9 (Geometry: intersection) Suppose two line segments intersect. The two endpoints 
for the first line segment are (xl, yl) and (x2, y2) and for the second line segment 
are (x3, y3) and (x4, y4). Write a program that prompts the user to enter these 
four endpoints and displays the intersecting point. (Hint: Use the 
LinearEquation class from Exercise 7.7.) 


Enter the endpoints of the first line segment: 2.0, 2.0, 0, 0 |^^nter 
Enter the endpoints of the second line segment: 0, 2.0, 2.0, 0 (^^nter 
The intersecting point is: (1.0, 1.0) 



*7.10 (The Time class) Design a class named Time. The class contains: 

■ The private data fields hour, mi nute, and second that represent a time. 

■ A constructor that constructs a Time object that initializes hour, minute, and 
second using the current time. 

■ The get methods for the data fields hour, minute, and second, respectively. 

■ A method named setTimeCelapseTime) that sets a new time for the object 
using the elapsed time in seconds. For example, if the elapsed time is 555550 
seconds, the hour is 10, the minute is 19, and the second is 12. 

Draw the UML diagram for the class, and then implement the class. Write a test 
program that creates a Time object and displays its hour, minute, and second. 
Your program then prompts the user to enter an elapsed time, sets its elapsed 
time in the Time object, and displays its hour, minute, and second. Here is a 
sample run: 


Current time is 12:41:6 _ 

Enter the elapsed time: 55550505 ^nter| 

The hour:minute:second for the elapsed time is 22:41:45 



(Hint: The initializer will extract the hour, minute, and second from the elapsed 
time. The current elapsed time can be obtained using time. timeC), as shown in 
Listing 2.7, ShowCurrentTime.py.) 
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CHAPTER 


8 

More on Strings 
AND Special Methods 

objectives 

■ To learn how to create strings (§8.2.1). 

■ To use the 1 en, mi n, and max functions to obtain the length of a string or 
the smallest or largest character in a string (§8.2.2). 

■ To access string elements by using the index operator ([]) (§8.2.3). 

■ To get a substring from a larger string by using the slicing 
str [start : end] operator (§8.2.4). 

■ To concatenate strings by using the + operator and to duplicate strings 
by using the operator (§8.2.5). 

■ To use the i n and not i n operators to determine whether a string 
is contained within another string (§8.2.6). 

■ To compare strings by using comparison operators (==, ! =, <, <=, >, 
and >=) (§8.2.7). 

■ To iterate characters in a string by using a for loop (§8.2.8). 

■ To test strings by using the methods 1 sal num, i sal pha, i sd1gi t, 
isidentifier, islower, isupper, and isspace (§8.2.9). 

■ To search for substrings by using the methods endswith, startswith, 
find, rfind, and count (§8.2.10). 

■ To convert strings by using the methods capi tal ize, 1 ower, upper, 
title, swapcase, and replace (§8.2.11). 

■ To strip whitespaces from the left and/or right of a string by using 
the methods 1 strip, rstrip, and strip (§8.2.12). 

■ To format strings by using the methods center, 1 just, r just, and 
format (§8.2.13). 

■ To apply strings in the development of applications (CheckPal indrome, 

HexToDecimalConversion) (§§8.3-8.4). 


To define special methods for operators (§8.5). 

To design the Rational class for representing rational numbers (§8.6). 
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8.1 Introduction 

The focus of this chapter is on class design using Python’s str class as an example 
and exploring the role of special methods in Python. 


The preceding chapter introduced the important concepts of objects and classes. You learned 
how to define classes as well as how to create and use objects. The str class is not only useful 
for processing strings, but it is also a good example of class design. This class was introduced 
in Chapter 3. We will discuss the str class in depth in this chapter. 

The special methods play an important role in Python. This chapter will also introduce 
special methods and operator overloading, and design classes using special methods. 


ir; P( 


Key 

Point 


8.2 The str Class 

A str object is immutable; that is, its content cannot be changed once the string is 
created. 



VideoNote 

String methods 


In Chapter 7, you learned how to define the classes Loan and BMI and create objects from 
these classes. You will frequently use the classes that come with the Python library to develop 
programs. This section introduces the Python str class. 

Strings are fundamental in computer science, and processing strings is a common task in 
programming. Strings are the objects of the str class. So far, you have used strings in input 
and output. The input function returns a string from the keyboard and the print function 
displays a string on the monitor. 


8.2.1 Creating Strings 

You can create strings by using the constructor, as follows: 

si = str() # Create an empty string object 

s2 = strC'Wel come") # Create a string object for Welcome 

Python provides a simple syntax for creating a string object by using a string value. For 
example. 


si = "" # Same as si = str() 

s2 = "Welcome" # Same as s2 = str("Welcome") 

A string object is immutable: once it is created, its contents cannot be changed. To opti¬ 
mize performance. Python uses one object for strings that have the same content. As 
shown in Figure 8.1, both si and s2 refer to the same string object and have the same id 
number. 

»> si = "Welcome" 

»> s2 = "Welcome" 

>» id (si) 

505408902 
»> id(s2) 

505408902 
»> 

Figure 8.1 Strings with the same content are actually the same object. 

This behavior is true for all immutable objects in the Python library. For example, int is 
an immutable class. Two int objects with the same value actually share the same object, as 
shown in Figure 8.2. 


sl- 


: str 


s2' 


str object for "Wei come" 
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»> X = 10 
»> y = 10 
»> id(x) 

35747680 
»> id(y) 

35747680 
»> 

Figure 8.2 All immutable objects with the same content are stored in one object. 

8.2.2 Functions for Strings 

Several of Python’s built-in functions can be used with strings. You can use the 1 en function 1 en 
to return the number of the characters in a string, and the max and min functions (introduced max 
in Chapter 3) to return the largest or smallest character in a string. Here are some examples: mi n 



1 

»> 

s = "Welcome" 

2 

»> 

len(s) 

3 

7 


4 

»> 

max(s) 

5 

■o' 


6 

»> 

min(s) 

7 

'W 


8 

»> 




Since s has 7 characters, 1 en(s) returns 7 (line 3). Note that the lowercase letters have a 
higher ASCII value than the uppercase letters, so maxfs) returns o (line 5) and minfs) 
returns W (line 7). 

Here is another example: 

s = inputC'Enter a string: ") 
if len(s) % 2 == 0: 

print(s, "contains an even number of characters") 

el se: 

print(s, "contains an odd number of characters") 

If you enter computer when running the code, it displays 
computer contains an even number of characters 

8.2.3 Index Operator [ ] 

A string is a sequence of characters. A character in the string can be accessed through the 
index operator using the syntax: 

s [i ndex] 

The indexes are 0 based; that is, they range from 0 to 1 enfs) -1, as shown in Figure 8.3. 0 based 
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s[0] s[l] s[10] 


Figure 8.3 The characters in a string can be accessed via an index operator. 
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For example, 



»> s = "Welcome" 

»> for 1 in range(0, len(s), 2): 
print(s[i], end = '') 

Wloe 

»> 


In the for loop, i is 0, 2, 4, and 6. So, s [0] , s [2] , s [4] , and s [6] are displayed. 
Python also allows the use of negative numbers as indexes to reference positions relative to 
the end of the string. The actual position is obtained by adding the length of the string with the 
negative index. For example. 


1 

»> 

s = "Welcome" 

2 

»> 

s[-l] 

3 

'e' 


4 

»> 

s[-2] 

5 

'm' 


6 

»> 




In line 2, s [-1] is the same as s [-1 + 1 en(s) ] , which is the last character in the string. In 
line 4, s [-2] is the same as s [-2 + Ten (s) ] , which is the second last character in the string. 

Note that since strings are immutable, you cannot change their contents. For example, the 
following code is illegal: 

s[2] = 'A' 

8.2.4 The Slicing Operator [start : end] 

slicing operator The slicing operator returns a slice of the string using the syntax s [start : end] . The slice 

is a substring from index start to index end - 1. For example. 


1 

»> s = 

"Wei come" 

2 

V 

V 

V 

1/1 

1 — 1 

: 4] 

3 

'elc' 




s[l : 4] returns a substring from index 1 to index 3. 

The starting index or ending index may be omitted. In this case, by default the starting 
index is 0 and the ending index is the last index. For example. 



1 

»> s = 

"Welcome" 

2 

l/l 

A 

A 

A 

6] 

3 

'Welcom 


4 

»> s[4 

: ] 

5 

' ome' 


6 

»> s[l 

: -1] 

7 

'el com' 


8 

»> 
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In line 2, s[ : 6] is the same as s[0 : 6], which returns a substring from index 0 to 
index 5. In line 4, s[4 ; ] is the same as s[4 : 7] , which returns a substring from index 4 
to index 6. You can also use a negative index in slicing. For example, in line 6, s [1 : -1] is negative index 
the same as s[l : -1 + lenCs)]. 

Note 

If index ( i or j) in the slice operation s[i : j] is negative, replace the index with 

len(s) + index. If j > len(s), j is set to 1en(s). If i >= j, the slice is 
empty. 

8.2.5 The Concatenation (+) and Repetition (*) Operators 

You can join, or concatenate, two strings by using the concatenation operator (+). You can concatenation operator 

also use the repetition operator (") to concatenate the same string multiple times. Here are repetition operator 

some examples: 



1 »> si = "Welcome" 

2 »> s2 = "Python" 

3 »> s3 = si + " to " + s2 

4 »> s3 

5 'Welcome to Python' 

6 »> s4 = 3 * si 

7 »> s4 

8 'WeicomeWelcomeWel come' 

9 »> s5 = si * 3 

10 »> s5 

11 'WeicomeWelcomeWel come' 

12 »> 



Note that 3 * si and si * 3 have the same effect (lines 6-11). 

8.2.6 The in and not in Operators 

You can use the i n and not i n operators to test whether a string is in another string. Here are 
some examples: 


»> si = "Welcome" 
»> "come" in si 
T rue 

»> "come" not in si 
Fal se 
»> 



Here is another example: 

s = inputC'Enter a string: ") 
if 'Python" in s: 

printC'Python", "is in", s) 






246 Chapter 8 More on Strings and Special Methods 


e1 se: 

printC'Python", "is not in", s) 

If you run the program by entering Wei come to Python as the string, the program should 
display 

python is in Welcome to Python. 


8.2.7 Comparing Strings 

You can compare strings by using the comparison operators (==, ! =, >, >=, <, and <=, intro¬ 
duced in Section 4.2). Python compares strings by comparing their corresponding characters, 
and it does this by evaluating the characters’ numeric codes. For example, a is larger than A 
because the numeric code for a is larger than the numeric code for A. See Appendix B, The 
ASCII Character Set, to find the numeric codes for characters. 

Suppose you need to compare the strings si ("Jane") with s2 ("Jake"). The first two 
characters (J vs. J) from si and s2 are compared. Because they are equal, the second two 
characters (a vs. a) are compared. Because they are equal, the third two characters (n vs. k) 
are compared. Since n has a greater ASCII value than k, si is greater than s2. 

Here are some examples: 


»> "green" 

Fal se 

== "glow" 

»> "green" 

T rue 

!= "glow" 

»> "green" 

T rue 

> "glow" 

»> "green" 

T rue 

>= "glow" 

»> "green" 

Fal se 

< "glow" 

»> "green" 

Fal se 

<= "glow" 

»> "ab" <= 

T rue 

»> 

"abc" 



Here is another example: 

1 si = InputC'Enter the first string: ") 

2 s2 = inputC'Enter the second string: ") 

3 if s2 < si: 

4 si, s2 = s2, si 

5 

6 printC'The two strings are in this order:", si, s2) 

If you run the program by entering Peter and then John, si is Peter and s2 is John 
(lines 1-2). Since s2 < si is True (line 3), they are swapped in line 4. Therefore the pro¬ 
gram displays the following message in line 6. 

The two strings are in this order: John Peter 
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8.2.8 Iterating a String 

A string is itemble. This means that you can use a for loop to traverse all characters in 
the string sequentially. For example, the following code displays all the characters in the 
string s: 

for ch in s: 
print(ch) 

You can read the code as “for each character ch in s, print ch.” 

The for loop does not use indexes to access characters. However, you still have to use 
indexes if you wish to traverse the characters in the string in a different order. For example, 
the following code displays the characters at odd-numbered positions in the string; 

for i in rangefO, len(s), 2): 
print(s[i]) 

The code uses variable i as the index for string s. i is initially 0, then increment by 2 suc¬ 
cessively, before it reaches or exceeds 1 en (s) . For each value i , s [i ] is printed. 

8.2.9 Testing Strings 

The str class has many useful methods. The methods in Figure 8.4 test the characters in the 
string. 


str 



isalnumO: bool 


Returns True if characters in this string are alphanumeric 
and there is at least one character. 

isalphaC): bool 


Returns True if characters in this string are alphabetic 
and there is at least one character. 

isdigitC): bool 


Returns True if this string contains only number characters. 

i si denti fi erO : bool 


Returns True if this string is a Python identifier. 

islowerf): bool 


Returns True if all characters in this string are lowercase 
lettters and there is at least one character. 

isupperO: bool 


Returns True if all characters in this string are uppercase 
lettters and there is at least one character. 

isspaceO: bool 


Returns True if this string contains only whitespace characters. 


Figure 8.4 The str class contains these methods for testing its characters. 
Here are some examples of using the string testing methods; 


1 »> s = "welcome to python" 

2 »> s.isainumO 

3 False 

4 »> "Wei come" . i sal pha() 

5 T rue 

6 »> "2012" . i sdi gi t() 

7 T rue 

8 »> "first Number" . i si denti fi er() 

9 False 


for loop 
iterable 
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string search methods 


10 »> s.islowerO 

11 True 

12 »> s.isupperO 

13 False 

14 »> s.isspaceO 

15 False 

16 »> 


s.isalnumC) returns False (line 2), because s contains spaces, which are not letters or 
numerals. Welcome contains all letters (line 4), so "Welcome". 1 salpha() returns True. 
Since 2012 contains all numerals, "2012". isdigitO returns True (line 6). And because 
first Number contains a space, it is not an identifier, so "first Number" .isidentifierC) 
returns Fal se (line 8). 

Here is another example: 

s = "2011" 
if s.isdigitO : 

printCs, "is a numeric string") 

The code displays 

2011 is a numeric string 

8.2.10 Searching for Substrings 

You can search for a substring in a string by using the methods in Figure 8.5. 


str 


endswith(sl: str): bool 


Returns True if the string ends with the substring si. 

startswith(sl: str): bool 


Returns True if the string starts with the substring si. 

find(sl): int 


Returns the lowest index where si starts in this string, or -1 if 
si is not found in this string. 

rfind(sl): int 


Returns the highest index where si starts in this string, or -1 if 
si is not found in this string. 

count(substring): int 


Returns the number of non-overlapping occurrences of this 
substring. 


Figure 8.5 The str class contains these methods for searching substrings. 


Here are some examples of using the string search methods: 



1 »> s = "welcome to python" 

2 »> s.endswithC'thon") 

3 T rue 

4 »> s.startswithC'good") 

5 False 

6 »> s.findC'come") 
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7 

3 


8 

»> 

s. fi ndC'become") 

9 

-1 


10 

»> 

s.rfind("o") 

11 

17 


12 

»> 

s. countC'o") 

13 

3 


14 

»> 



Since come is found in string s at index 3, s. findC'come") returns 3 (line 7). Because 
the first occurrence of substring o from the right is at index 17, s. rfindC'o") returns 17 
(line 11). In line 8, s.findC'become") returns -1, since become is not in s. In line 12, 
s.countC'o") returns 3, because o appears three times in s. 

Here is another example: 

s = inputC'Enter a string: 
if s.startswi thC'comp") : 

printfs, "begins with comp") 
if s.endswithC'er") : 

print(s, "ends with er") 

printC'e', "appears", s.count('e') , "time in", s) 


If you enter computer when running the code, it displays 

computer begins with comp 
computer ends with er 
e appears 1 time in computer 


8.2.11 Converting Strings 

You can make a copy of a string by using the methods shown in Figure 8.6. These methods 
let you control the capitalization of letters in the string’s copy, or to replace the string 
entirely. 


str 


capitalizeO : str 


Returns a copy of this string with only the first character capitalized. 

lower(): str 


Returns a copy of this string with all letters converted to lowercase. 

upper(): str 


Returns a copy of this string with all letters converted to uppercase. 

title(): str 


Returns a copy of this string with the first letter capitalized in each word. 

swapcaseO : str 


Returns a copy of this string in which lowercase letters are converted to 
uppercase and uppercase to lowercase. 

replace(old, new): str 


Returns a new string that replaces all the occurrences of the old string 
with a new string. 


Figure 8.6 The str class contains these methods for converting letter cases in strings and for replacing one string with 
another. 
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The capita! ize() method returns a copy of the string in which the first letter in the 
string is capitalized. The lowerC) and upper() methods return a copy of the string in 
which all letters are in lowercase or uppercase. The titleC) method returns a copy of the 
string in which the first letter in each word is capitalized. The swapCaseC) method returns 
a copy of the string in which the lowercase letters are converted to uppercase and the upper¬ 
case letters are converted to lowercase. The rep! ace (old, new) method returns a new 
string that replaces the substring ol d with substring new. Here are some examples of using 
these methods: 


1 »> s = "welcome to python" 

2 »> si = s.capitalizeO 

3 »> si 

4 'Welcome to python' 

5 »> s2 = s.titleO 

6 »> s2 

7 'Welcome To Python' 

8 »> s = "New England" 

9 »> s3 = s.lowerO 

10 »> s3 

11 'new england' 

12 »> s4 = s.upperO 

13 »> s4 

14 'NEW ENGLAND' 

15 »> s5 = s.swapcaseO 

16 »> s5 

17 'nEW eNCLAND' 

18 »> s6 = s. repl aceC'Engl and" , "Haven") 

19 »> s6 

20 'New Haven' 

21 »> s 

22 'New England' 

23 »> 



Note 

As stated earlier, a string is immutable. None of the methods in the str class changes 
the contents of the string: instead, these methods create new strings. As shown in the 
preceding script, s is still New England (lines 21-22) after applying the methods 

S.lowerO, s.upperO, s.swapcaseO, and s. repl ace("Engl and", 
"Haven"). 


8.2.12 Stripping Whitespace Characters from a String 

You can use the methods in Figure 8.7 to strip whitespace characters from the front, end, or 
both the front and end of a string. Recall that the characters , \t, \f , \r, and \n are called 
the whitespace characters (Section 3.5). 
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str 

IstripO 

str 

rstri p() 

str 

StripO : 

str 


Returns a string with the leading whitespace characters removed. 

Returns a string with the trailing whitespace characters removed. 

Returns a string with the starting and trailing whitespace characters 
removed. 


Figure 8.7 The str class contains these methods for stripping leading and trailing white- 
space characters. 


Here are some examples of using the string stripping methods: 


1 »> s = " Welcome to Python\t" 

2 »> si = s.lstripO 

3 »> si 

4 'Welcome to Python\t' 

5 »> s2 = s.rstripO 

6 »> s2 

7 ' Welcome to Python' 

8 »> s3 = s.stripO 

9 »> s3 

10 'Welcome to Python' 

11 »> 


In line 2, s.lstripO strips the whitespace characters in s from the left. In line 5, 
s. rstripO strips the whitespace characters in s from the right. In line 8, s. stripO strips 
the whitespace characters in s from both the left and right. 

Note 

The stripping methods only strip the whitespace characters in the front and end of a 
string. The whitespace characters surrounded by non-whitespace characters are not 
stripped. 




Tip 

It is a good practice to apply the stripC) method on an input string to ensure that any 
unwanted whitespace characters at the end of the input are stripped. 


8.2.13 Formatting Strings 

You can use the methods in Figure 8.8 to return a formatted string. 


str 

centerCwidth) 

str 

1 just(width): 

str 

rjust(width) : 

str 

format(i terns) 

str 


Returns a copy of this string centered in a field of the given width. 
Returns a string left justified in a field of the given width. 

Returns a string right justified in a field of the given width. 
Formats a string. 


Figure 8.8 The str class contains these formatting methods. 


















252 Chapter 8 More on Strings and Special Methods 


Here are some examples that use the center, 1 just, and r just methods: 



1 »> s = "Welcome" 

2 »> si = s.center(ll) 

3 »> si 

4 ' Welcome ' 

5 »> s2 = s.ljust(ll) 

6 »> s2 

7 'Welcome ' 

8 »> s3 = s.rjust(ll) 

9 »> s3 

10 ' Welcome' 

11 »> 


In line 2, s.center(ll) places s in the center of a string with 11 characters. In line 5, 
s.l just(ll) places s at the left of a string with 11 characters. In line 8, s.rjust(ll) 
places s at the right of a string with 11 characters. 

Section 3.6 introduced the format function for formatting a number or a string. The str 
class has a format method, covered in Supplement II.C, which is very similar to the format 
function. 

8.1 Suppose that si, s2, s3, and s4 are four strings, given as follows: 

si = "Welcome to Python" 

MyProgrammingLab" s 2 = si 

s3 = "Welcome to Python" 
s4 = "to" 



What are the results of the following expressions? 


a. si == s2 

b. s2.countC 'o' ) 

c. Id(sl) == id(s2) 

d. Id(sl) == ld(s3) 

e. si <= s4 

f. s2 >= s4 

g. si != s4 

h. sl.upperO 
1. sl.flnd(s4) 

j. si [4] 

k. sl[4 : 8] 


1 . 

4 * s4 

m. 

len(sl) 

n. 

max(sl) 

0 . 

mi n(sl) 

P- 

sl[-4] 

q- 

si.lower () 

r . 

sl.rfind('o') 

s . 

sl.startswithC "o 

t. 

sl.endswithC'o") 

u . 

si.isal pha() 

V . 

si + si 


8.2 Suppose that si and s2 are two strings. Which of the following statements or expres¬ 
sions are incorrect? 


si = "programming 101" 

s2 = "programming is fun" 

s3 = si + s2 

s3 = si - s2 

si == s2 
si >= s2 
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1 = len(sl) 
c = sl[0] 
t = sl[ : 5] 
t = sl[5 : ] 

8.3 What is the printout of the following code? 

si = "Welcome to Python" 
s2 = sl.replace("o","abc") 
print(sl) 
print(s2) 

8.4 Let si be " Wei come " and s2 be " wel come Write the code for the following 
statements: 

(a) Check whether si is equal to s2 and assign the result to a Boolean variable 

isEqual. 

(b) Check whether si is equal to s2, ignoring case, and assign the result to a 
Boolean variable i sEqual . 

(c) Check whether si has the prefix AAA and assign the result to a Boolean variable b. 

(d) Check whether si has the suffix AAA and assign the result to a Boolean variable b. 

(e) Assign the length of si to a variable x. 

(f) Assign the first character of si to a variable x. 

(g) Create a new string s3 that combines si with s2. 

(h) Create a substring of si starting from index 1. 

(i) Create a substring of si from index 1 to index 4. 

(j) Create a new string s3 that converts si to lowercase. 

(k) Create a new string s3 that converts si to uppercase. 

(l) Create a new string s3 that trims whitespace characters on both ends of si. 

(m) Replace e with E in si. 

(n) Assign the index of the first occurrence of character e in si to a variable x. 

(o) Assign the index of the last occurrence of string abc in si to a variable x. 

8.5 Does any method in the string object change the contents of the string? 

8.6 Suppose string s is an empty string; what is lenCs)? 

8.7 How do you determine whether a character is in lowercase or uppercase? 

8.8 How do you determine whether a character is alphanumeric? 


8.3 Case Study: Checking Palindromes 

This section presents a program that checks whether a string is a palindrome. 

A string is a palindrome if it reads the same forward and backward. The words “mom,” “dad,” 
and “noon,” for instance, are all palindromes. 

The problem is to write a program that prompts the user to enter a string and reports 
whether the string is a palindrome. One solution is to have the program check whether the first 
character in the string is the same as the last character. If so, then the program can check 
whether the second character is the same as the second-to-last character. This process contin¬ 
ues until a mismatch is found or all the characters in the string are checked, except for the 
middle character if the string has an odd number of characters. 


c/Key 
'P ) Point 
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input string 


low index 


high index 


update indexes 


To implement this idea, use two variables, say 1 ow and high, to denote the position of two 
characters at the beginning and the end in a string s, as shown in Listing 8.1 (lines 13 and 16). 
Initially, low is 0 and high is len(s) - 1. If the two characters at these positions match, 
increment low by 1 and decrement high by 1 (lines 22-23). This process continues until 
(1 ow >= high) or a mismatch is found. 

Listing 8.1 CheckPal i nd rome. py 

1 def mainO : 

2 # Prompt the user to enter a string 

3 s = inputC'Enter a string: ').strip() 

4 

5 if isPalindrome(s): 

6 print(s, "is a palindrome") 

7 else: 

8 print(s, " is not a palindrome") 

9 

10 # Check if a string is a palindrome 

11 def isPalindrome(s) : 

12 # The index of the first character in the string 

13 low = 0 

14 

15 # The index of the last character in the string 

16 high = len(s) - 1 

17 

18 while low < high: 

19 if s[low] != s[high] : 

20 return False # Not a palindrome 

21 

22 low += 1 

23 high -= 1 

24 

25 return True # The string is a palindrome 

26 

27 mainO # Call the main function 



Enter a string: noon | *-i Enter 
noon is a palindrome 


Enter a string: moon pEnter | 
moon is not a palindrome 


The program prompts the user to enter a string into s (line 3), which uses the stripO 
method to remove any starting and ending whitespace characters, and then invokes 
isPal indrome(s) to determine whether s is a palindrome (line 5). 




8.4 Case Study: Converting Hexadecimals to Decimals 

This section presents a program that converts a hexadecimal number into a decimal 
number. 


Section 6.8 illustrates a program that converts a decimal number to hexadecimal format. How 
do you convert a hex number into a decimal? 
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Given a hexadecimal number h„h„^ih „^2 ■ ■ ■ the equivalent decimal value is 

h„ X 16" + X 16"^^ + /!„_2 X 16"^^ + .. . + /!2 X 16^ + /?! X 16* + hoX 16° 

For example, the hex number AB8C is 

10 X 16^ + 11 X 16^ + 8 X 16* + 12 X 16° = 43916 

Our program will prompt the user to enter a hex number as a string and convert it into a 
decimal by using the following function; 

def hexToDeci trial (hex) : 

A brute-force approach is to convert each hex character into a decimal number, multiply it 
by 16' for a hex digit at the i’s position, and add all the items together to obtain the equivalent 
decimal value for the hex number. 

Note that: 

h„ X 16" /i„_i X 16"^' -h /i„_2 X 16"^2 4- .. . -f /zi X 16^ 4- /zq X 16° 

= ( . . . ((/z„ X 16 -f /z„-i) X 16 4- /z„_ 2 ) X 16 -f . . . 4- hi) X 16 4- /zq 

This observation, known as Honor’s algorithm, leads to the following code for converting 
a hex string to a decimal number: 

decimalValue = 0 
for i in range(len(hex)): 
hexChar = hex[i] 

decimalValue = decimalValue * 16 + hexCharToDecimal(hexChar) 

The following is a trace of the algorithm for hex number AB8C. 



i 

hexChar 

hexCharToDecimal 

(hexChar) 

DecimalValue 

before the loop 




0 

after the 1st iteration 

0 

A 

10 

10 

after the 2nd iteration 

1 

B 

11 

10 “ 16 + 11 

after the 3rd iteration 

2 

8 

8 

(10 - 16 + 11) *16+8 

after the 4th iteration 

3 

C 

12 

((10 * 16 + 11) * 16 + 8) * 16 + 12 




Listing 8.2 shows the complete program. 


Listing 8.2 HexToDeci mal Conversi on. py 

1 def mai n () : 

2 # Prompt the user to enter a hex number 

3 hex = i nputC'Enter a hex number: ").strip() inputstring 

4 

5 decimal = hexToDecimal (hex.upperO) hex to decimal 

6 if decimal == None: 

7 pri ntC'Incorrect hex number") 

8 el se: 
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cannot convert 


hex char to decimal 


None 


9 printCThe decimal value for hex number", 

10 hex, 'is", decimal) 

11 

12 def hexToDecimal(hex): 

13 decimalValue = 0 

14 for i in range(len(hex)): 

15 ch = hex[i] 

16 if 'A' <= ch <= ' F' or 'O' <= ch <= 9' : 

17 decimalValue = decimalValue * 16 + \ 

18 hexCharToDecimal(ch) 

19 else: 

20 return None 

21 

22 return decimalValue 

23 

24 def hexCharToDecimal(ch): 

2 5 if ch <=' F' : 

26 return 10 + ord(ch) - ord('A') 

27 else: 

28 return ord(ch) - ord('O') 

29 

30 mainO # Call the main function 



Enter a hex number: AB8C [ —I Enter | 

The decimal value for hex number AB8C is 43916 



Enter a hex number: af71 Enter | 

The decimal value for hex number af71 is 44913 


Enter a hex number: ax71 
Incorrect hex number 


The program reads a string from the console (line 3) and invokes the hexToDeci mal func¬ 
tion to convert a hex string to a decimal number (line 5). The characters can be entered in 
either lowercase or uppercase, and the program converts them to uppercase before invoking 

the hexToDecimal function. 

The hexToDecimal function is defined in lines 12-22 to return an integer. The length of 
the string is determined by invoking len (hex) in line 14. This function returns None for an 
incorrect hex number (line 20). 

The hexCharToDecimal function is defined in lines 24-28 to return a decimal 
value for a hex character. The character can be in either lowercase or uppercase. 
Invoking hex. upper () converts the characters to uppercase. When invoking 
hexCharToDecimal (ch), the character ch is already in uppercase. If ch is a letter 
between A and F, the program returns a decimal value 10 + ordCch) - ordC'A') 
(line 26). If ch is a digit, the program returns a decimal value ord(ch) - ordC'O') 
(line 28). 
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8.5 Operator Overloading and Special Methods 

Python allows you to define special methods for operators and functions to perform 
common operations. These methods are named in a specific way for Python to 
recognize the association. 


^/Key 
^ ) Point 


In the preceding sections, you learned how to use operators for string operations. You can use 
the + operator to concatenate two strings, the * operator to concatenate the same string multi¬ 
ple times, the relational operators (==, ! =, <, <=, >, and >=) to compare two strings, and the 
index operator [ ] to access a character. For example. 


1 si = "Washington" 

2 s2 = "California" 

3 printC'The first character in si is", sl[ 0 ) 

4 printC'sl + s2 is", si + s2 ) 

5 printC'sl < s2?", si < s2 ) 


[] operator 
+ operator 
< operator 


The operators are actually methods defined in the str class. Defining methods for opera¬ 
tors is called operator overloading. Operator overloading allows the programmer to use the operator overloading 
built-in operators for user-defined methods. Table 8.1 lists the mapping between the operators 
and methods. You name these methods with two starting and ending underscores so Python 
will recognize the association. For example, to use the + operator as a method, you would 
define a method named _add_ . Note that these methods are not private, because they have 
two ending underscores in addition to the two starting underscores. Recall that the initializer 
in a class is named _i ni t__ , which is a special method for initializing an object. 

For example, you can rewrite the preceding code using the methods as follows: 

1 si = "Washington" 

2 s2 = "California" 

3 printC'The first character in si is", si._getitem_ (0)) _getitem _method 


Table 8.1 Operator Overloading: Operators and Special Methods 

Operator/Function Method Description 


+ 

_ add _ (self, other) 

Addition 


_mul_(self, other) 

Multiplication 

- 

_ sub _ (self, other) 

Subtraction 

/ 

_truediv_(self, other) 

Division 

% 

_mod_(self, other) 

Remainder 

< 

_ It _ (self, other) 

Less than 

<= 

_ le _ (self, other) 

Less than or equal to 

== 

_ eq _ (self, other) 

Equal to 

1 = 

_ ne _ (self, other) 

Not equal to 

> 

_gt_(self, other) 

Greater than 

>= 

_ge_(self, other) 

Greater than or equal to 

[index] 

_getitem_(self, index) 

Index operator 

in 

_contains_(self, value) 

Check membership 

1en 

_len_(sel f) 

The number of elements 

str 

_str_(sel f) 

The string representation 
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add_method 

.11_method 


_contai ns_method 

i n operator 


i n operator 

_contai ns_method 


_i en_method 

Ten method 


Ten function 
_ ^ en_method 


4 printC'sl + s2 is", si._add_(s2)) 

5 printC'sl < s2?", si._It_(s2)) 

si._getitem_(0) is the same as sl[0], si._add_Cs2) is the same as si + 

s2, and si._11_Cs2) is the same as si < s2. Now you can see the advantages of oper¬ 

ator overloading. Using operators greatly simplifies programs, making them easier to read 
and maintain. 

Python supports the i n operator, which can he used to determine whether a character is in 
a string or an element is a member of a container. The corresponding method is named 

_contains_(self, e) . You can use the method _contains_ or the i n operator to 

see if a character is in a string, as shown in the following code: 

1 si = "Washington" 

2 printC'Is W in si?", 'W' in si) 

3 printC'Is W in si?", si._contains ('W')) 

W in si is the same as si._contains_C'W'). 

If a class defines the _len_(sel f) method. Python allows you to invoke the method 

using a convenient syntax as a function call. For example, the_ I en_ method is defined in 

the str class, which returns the number of characters in a string. You can use the method 
_ 1 en_ or the function 1 en to get the number of characters in a string, as shown in the fol¬ 
lowing code: 

1 si = "Washington" 

2 printC'The length of si is", len(sl)) 

3 printC'The length of si is", si. len_()) 

len(sl) is the same as si._len_(). 

Many of the special operators are defined in Python built-in types such as i nt and fl oat. 

For example, suppose i is 3 and j is 4. i._add_Cj) is the same as i -i- j and 

i.__sub__Cj) is the same as i - j . 


print object 



Note 

You can pass an object to invoke print(x). This is equivalent to invoking 

printCx. _ str _ ()) or print(str(x)). 



Note 

The comparison operators <, <=, ==, !=, >, and >= can also be implemented using the 

_cmp_(self, other) method. This method returns a negative integer if self 

< other, zero if sel f == other, and a positive integer if sel f > other. For two 

objects a and b, a < b calls a. _ It _ (b) if the _lt__ is available. If not, the 

__cmp_ method is called to determine the order. 


/Check 
{. Point 

MyProgrammingLab'' 


8.9 What is operator overloading? 

8.10 What are the special methods for the operators -i-, 
and >=? 


/, %, 


<, <=, >, 


t / Foil 


Key 

Point 


8.6 Case Study: The Rational Class 

This section shows how to design the Rational class for representing and processing 
rational numbers. 


VideoNote 

Define classes 


A rational number has a numerator and a denominator in the form a/b, where a is the numera¬ 
tor and b is the denominator. For example, 1/3, 3/4, and 10/4 are rational numbers. 
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A rational number cannot have a denominator of 0, but a numerator of 0 is fine. Every inte¬ 
ger is equivalent to a rational number i/1. Rational numbers are used in exact computations 
involving fractions—for example, 1/3 = 0.33333.... This number cannot be precisely 

represented in floating-point format using data type float. To obtain the exact result, we 
must use rational numbers. 

Python provides data types for integers and floating-point numbers but not for rational 
numbers. This section shows how to design a class for rational numbers. 

A rational number can be represented using two data fields: numerator and 
denomi nator. You can create a rational number with a specified numerator and denominator 
or create a default rational number with the numerator 0 and denominator 1. You can add, 
subtract, multiply, divide, and compare rational numbers. You can also convert a rational 
number into an integer, floating-point value, or string. The UML class diagram for the 
Rational class is given in Figure 8.9. 


Rational 

-numerator: int 
-denominator: int 


Rational(numerator =0: int, 
denominator = 1: int) 

_add_(secondRational: 

Rational): Rational 

_sub_(secondRational: 

Rational): Rational 

_mul_(secondRational : 

Rational): Rational 

_truediv (secondRational: 

Rational): Rational 

_It_(secondRational : 

Rational): bool 

Also_le_,_eq_,_ne_, 

_gt , ge are supported 

_i nt_0 : i nt 

_float_0 : float 

_str_0 : str 


_geti tern_(i) 


The numerator of this rational number. 

The denominator of this rational number. 

Creates a rational number with a specified numerator (default 0) 
and denominator (default 1). 

Returns the addition of this rational number with another. 
Returns the subtraction of this rational number with another. 
Returns the multiplication of this rational number with another. 
Returns the division of this rational number with another. 
Compares this rational number with another. 


Returns the numerator divided by denominator as an integer. 

Returns the numerator divided by denominator as a float. 

Returns a string in the form “numerator/denominator.” Returns 
the numerator if the denominator is 1. 

Returns numerator using [0] and denominator using [1]. 


Figure 8.9 The UML diagram for the properties, initializer, and methods of the Rational class. 


There are many equivalent rational numbers; for example, 1/3 = 2/6 = 3/9 = 
4/12. For convenience, 1/3 is used to represent all rational numbers that are equivalent to 
1/3. The numerator and the denominator of 1/3 have no common divisor except 1, so 1/3 is 
said to be in lowest terms. 

To reduce a rational number to its lowest terms, you need to find the greatest common divi¬ 
sor (GCD) of the absolute values of its numerator and denominator and then divide both 
numerator and denominator by this value. You can use the function for computing the GCD of 
two integers n and d, as suggested in Listing 5.8, GreatestCommonDivisor.py. The numerator 
and denominator in a Rational object are reduced to their lowest terms. 
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As usual, we first write a test program to create Rational objects and test the functions in 
the Rational class. Listing 8.3 is a test program. 


Listing 8.3 TestRationalClass.py 


import Rati onal 


create Rati onal 


import Rational 

# Create and initialize two rational 
rl = Rati onal. Rati onal (4 , 2) 
r2 = Rati onal. Rati onal (2 , 3) 



7 

# Display 

results 


invoke add 

8 

print(rl, 


r2, • 

'=", rl + r2) 

invoke subtract 

9 

print(rl, 


r2, • 

'=", rl - r2) 

invoke multiply 

10 

print(rl, 

11 >•. 11 

r2, 

■=", rl * r2) 

invoke di vi de 

11 

print(rl, 


r2, ■ 

■=", rl / r2) 


12 





compare two numbers 

13 

print(rl, 


r2, 

'is", rl > r2) 


14 

print(rl, 


r2, 

"is", rl >= r2) 


15 

print(rl, 


r2, 

’is", rl < r2) 


16 

print(rl, 


r2, 

'is", rl <= r2) 


17 

print(rl, 

II_11 

- 1 

r2, 

"is", rl == r2) 


18 

print(rl, 

II 

■ — 1 

r2, 

’is", rl != r2) 


19 





get int value 

20 

pri nt("int(r2) 

is", 

int(r2)) 


21 

print("noatCr2) is' 

', float(r2)) 


22 





index operator 

23 

print("r2[0] is 

", r2D.]) 


24 

print("r2[l] is 

", r2[l]) 


numbers rl and r2. 


2 + 2/3 = 8/3 

2 - 2/3 = 4/3 

2 * 2/3 = 4/3 

2 / 2/3 = 3 

2 > 2/3 is True 
2 >= 2/3 is True 
2 < 2/3 is False 
2 <= 2/3 is False 
2 == 2/3 is False 
2 != 2/3 is True 
int(r2) is 0 

float(r2) is 0.6666666666666666 
r2[0] is 2 
r2[l] is 3 


The program creates two rational numbers, rl and r2 (lines 4 and 5), and displays the 
results of rl + r2, rl - r2, rl * r2, and rl / r2 (lines 8-11). rl + r2 is equivalent 

to rl._add_Cr2). 

The printCrl) function prints the string returned from str(rl). Invoking str(rl) 
returns a string representation for the rational number rl, which is the same as invoking 

rl._str_C). 

Invoking intCr2) (line 20) returns an integer for the rational number r2, which is the 
same as invoking r2._int_(). 

Invoking floatCr2) (line 21) returns a float for the rational number r2, which is the 
same as invoking r2._fl oat_() . 
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Invoking r2[0] (line 23) is the same as invoking r2._getitem_(0), which returns 

the numerator from r2. 

The Rational class is implemented in Listing 8.4. 


Listing 8.4 Rati onal. py 


1 

class Rational: 



2 

def _init_(self, numerator = 1, denominator = 0): 

initializer 

3 

divisor = gcd(numerator, denominator) 

gcd 


4 

self._numerator = (1 if denominator > 0 else -1) \ 

initialize numerator 

5 

* int(numerator / divisor) 



6 

self._denominator = int(abs(denominator) / divisor) 

initialize denominator 

8 

# Add a rational number to this rational number 



9 

def _add_(self, secondRational) : 

add 


10 

n = self._numerator * secondRational [1] + \ 

a i c _ 

ad + be 

bd 

11 

self._denominator * secondRational [0] 


12 

d = self._denominator * secondRational [1] 



13 

return Rational(n, d) 



14 




15 

# Subtract a rational number from this rational number 



16 

def _sub_(self, secondRati onal) : 

subtract 

17 

n = self._numerator * secondRational [1] - \ 

a c 

ad — be 


bd 

18 

self._denominator * secondRational [0] 



19 

d = self._denominator * secondRational [1] 



20 

return Rational(n, d) 



21 




22 

# Multiply a rational number by this rational number 



23 

def _mul_(self, secondRational) : 

multi ply 

24 

n = self._numerator * secondRational[0] 

ixit = 

ae 

bd 

25 

d = self._denominator * secondRational [1] 



26 

return Rational(n, d) 



27 




28 

# Divide a rational number by this rational number 



29 

def _truediv_(self, secondRational): 

divide 


30 

n = self._numerator * secondRational [1] 

a , c 

b ' d ~ 

ad 

31 

d = self._denominator * secondRati onal [0] 



32 

return Rational(n, d) 



33 




34 

# Return a float for the rational number 



35 

def _float_(self): 

float 


36 

return self._numerator / self._denominator 



37 




38 

# Return an integer for the rational number 



39 

def _i nt_(sel f) : 

int 


40 

return int(self._float_()) 



41 




42 

# Return a string representation 



43 

def _str_(sel f) : 

str 


44 

if self._denominator == 1: 



45 

return str(self._numerator) 



46 

el se: 



47 

return str(self._numerator) + "/" , self._denominator) 



48 




49 

def _It_(self, secondRational): 

It 


50 

return self._cmp_(secondRational) < 0 



51 




52 

def _le_(self, secondRational): 



53 

return self._cmp_(secondRational) <= 0 



54 
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cmp 


getitern 


gcd 


55 

56 

57 

58 

59 

60 
61 
62 

63 

64 

65 

66 

67 

68 

69 

70 

71 

72 

73 

74 

75 

76 

77 

78 

79 

80 
81 
82 

83 

84 

85 

86 

87 

88 
89 


def _gt_(self, secondRatlonal) : 

return self._cmp_(secondRatlonal) > 0 

def _ge_(self, secondRatl onal) : 

return self._cmp_(secondRatlonal) >= 0 

# Compare two numbers 

def _cmp_(self, secondRatl onal) : 

temp = self._sub_(secondRatlonal) 

If temp[0] > 0: 

return 1 

el if temp[0] < 0: 

return -1 
el se: 

return 0 

# Return numerator and denominator using an Index operator 

def _getltem_(self, index): 

if index == 0: 

return self._numerator 

el se: 

return self._denominator 

def gcd(n, d) : 
nl = abs(n) 
n2 = abs(d) 
gcd = 1 

k = 1 

while k <= nl and k <= n2: 

if nl % k == 0 and n2 % k == 0: 

gcd = k 
k += 1 

return gcd 


The rational number is encapsulated in a Rational object. Internally, a rational number is 
represented in its lowest terms (lines 4-6), and the numerator determines its sign (line 4). The 
denominator is always positive (line 6). The data fields numerator and denominator are 
defined as private with two leading underscores. 

The gcd() is not a member method in the Rational class, but a function defined in the 
Rational module (Rational.py) (lines 78-89). 

Two Rational objects can interact with each other to perform addition, subtraction, mul¬ 
tiplication, and division operations. These methods return a new Rational object (lines 
9-32). Note that secondRational [0] refers to the numerator of secondRational and 
secondRational [1] refers to the denominator of secondRational . The use of the index 
operator is supported by the _getitemCi)_ method (lines 72-76), which returns the 
numerator and denominator of the rational number based on the index. 

The _cmp_(secondRational ) method (lines 62-69) compares this rational number 

to the other rational number. It first subtracts the second rational from this rational and saves 
the result in temp (line 63). The method returns -1, 0, or 1 if temp’s numerator is less than, 
equal to, or greater than 0. 

The comparison method _lt_ , _le_ , _gt _ , and ._ge_ are implemented 

using the _cmp method (lines 49-59). Note that the methods __ne_ and _eq _ are 

not implemented explicitly, but they are implicitly implemented by Python if the _ _cmp _ 

method is available. 

You have used the str, int, and float functions to convert an object to a str, int, or 
float. The methods _str_ C), _int _ C),and afloat _() are implemented in the 
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Rational class (lines 35-47) to return a str object, int object, or float object from a 
Rational object. 

8.1 I Will the program work if you replace line 63 in Rational.py with the following code? 
temp = self - secondRational 

8.12 Will the program work if you replace the _str_ method in lines 43^7 as follows? 

def _str_(sel f) : 

if self._denominator == 1: 

return str(self[0]) 

el se : 

return str(self[0]) + "/" + str(self[l]) 


Key Terms 


concatenation operator 245 

operator overloading 257 

index operator 260 

repetition operator 245 

iterable 247 

slicing operator 244 

Chapter Summary 



I. A string object is immutable. Its contents cannot be changed. 


2. You can use the Python functions 1 en, mi n, and max to return the length of a string, 
and the minimum and maximum elements in a string. 

3. You can use the index operator [ ] to reference an individual character in a string. 

4. You can use the concatenate operator to concatenate two strings, the repetition 
operator * to duplicate strings, the slicing operator [ ; ] to get a substring, and the 
i n and not i n operators to check whether a character is in a string. 

5. The comparison operators ( — :, ! =, <, <=, >, and >=) can be used to compare two strings. 

6 . You can use a/or loop to iterate all characters in a string. 

7. You can use the methods such as endswith, startswith, isalpha, islower, 
isupper, lower, upper, find, count, replace, and strip on a string object. 

8 . You can define special methods for overloading the operators. 

Test Questions 

Do test questions for this chapter online at www.cs.armstrong.edu/liang/py/test.html. 

Programming Exercises 

Sections 8.2-8.4 

*8.1 (Check SSN) Write a program that prompts the user to enter a Social Security 
number in the format ddd-dd-dddd, where r/ is a digit. The program displays 
Valid SSN for a correct Social Security number or Inval id SSN otherwise. 


iCheck 
W Point 

MyProgrammingLab" 


MyProgrammingLab" 






More on Strings and Special Methods 


264 Chapter 8 


**8.2 (Check substrings) You can check whether a string is a substring of another string 
by using the f i nd method in the str class. Write your own function to implement 
f i nd. Write a program that prompts the user to enter two strings and then checks 
whether the first string is a substring of the second string. 

**8.3 (Check password) Some Web sites impose certain rules for passwords. Write a 
function that checks whether a string is a valid password. Suppose the password 
rules are as follows: 

■ A password must have at least eight characters. 

■ A password must consist of only letters and digits. 

■ A password must contain at least two digits. 

Write a program that prompts the user to enter a password and displays val i d 
password if the rules are followed or i nval i d password otherwise. 

8.4 (Occurrences of a specified character) Write a function that finds the number of 
occurrences of a specified character in a string using the following header: 

def countfs, ch): 

The str class has the count method. Implement your method without using the 
count method. For example, count ("Wei come", ' e ') returns 2. Write a test 
program that prompts the user to enter a string followed by a character and dis¬ 
plays the number of occurrences of the character in the string. 

**8.5 (Occurrences of a specified string) Write a function that counts the occurrences of a 

specified non-overlapping string s2 in another string si using the following header: 

def count(sl, s2): 

For example, countC'system error, syntax error", "error") returns 
2. Write a test program that prompts the user to enter two strings and displays the 
number of occurrences of the second string in the first string. 

* 8.6 (Count the letters in a string) Write a function that counts the number of letters in 
a string using the following header: 

def countLetters(s): 

Write a test program that prompts the user to enter a string and displays the num¬ 
ber of letters in the string. 

*8.7 (Phone keypads) The international standard letter/number mapping for telephones is: 



Write a function that returns a number, given an uppercase letter, as follows: 
def getNumber(uppercaseLetter): 

Write a test program that prompts the user to enter a phone number as a string. The 
input number may contain letters. The program translates a letter (uppercase or 
lowercase) to a digit and leaves all other characters intact. Here is a sample run of 
the program: 
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Enter a string: 
1-800-3569377 

1-800-Flowers h Enter 1 



Enter a string: 
18003569377 

1800f lowers Enter 1 




*8.8 {Binary to decimal) Write a function that parses a binary number as a string into a 
decimal integer. Use the function header: 

def bi naryToDeci trial (bi naryStri ng) : 

For example, binary string 10001 is 17 (1 X 2"^ + 0 X 2^ + 0 X 2^ + 0 X 2 
+ 1 = 17). So, binaryToDecimal ("10001") returns 17. 

Write a test program that prompts the user to enter a binary string and displays the 
corresponding decimal integer value. 

**8.9 {Binary to hex) Write a function that parses a binary number into a hex number. 
The function header is: 

def binaryToHex(binaryValue): 

Write a test program that prompts the user to enter a binary number and displays 
the corresponding hexadecimal value. 

**8.10 {Decimal to binary) Write a function that parses a decimal number into a binary 
number as a string. Use the function header: 

def decimalToBinary(value): 

Write a test program that prompts the user to enter a decimal integer value and dis¬ 
plays the corresponding binary value. 

Section 8.5 

*8.1 I {Reverse a string) Write a function that reverses a string. The header of the func¬ 
tion is: 

def reverse(s): 

Write a test program that prompts the user to enter a string, invokes the reverse 
function, and displays the reversed string. 

*8.12 {Bioinformatics: find genes) Biologists use a sequence of letters A, C, T, and G to 
model a genome. A gene is a substring of a genome that starts after a triplet ATG 
and ends before a triplet TAG, TAA, or TGA. Furthermore, the length of a gene 
string is a multiple of 3 and the gene does not contain any of the triplets ATG, TAG, 
TAA, and TGA. Write a program that prompts the user to enter a genome and dis¬ 
plays all genes in the genome. If no gene is found in the input sequence, the pro¬ 
gram displays no gene is found. Here are the sample runs: 


Enter a genome string: TTATCTTTTAACGATGGCGCCTTACTT Enter 

TTT 

GGGGGT 
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Enter a genome string: TGTCTGTATAT pEnter| 
no gene is found 

*8.13 

(Longest common prefix) Write a method that returns the longest common prefix 
of two strings. For example, the longest common prefix of distance and 
disinfection is dis. The header of the method is: 

**8.I4 

def prefix(sl, s2) 

If the two strings have no common prefix, the method returns an empty string. 

Write a mai n method that prompts the user to enter two strings and displays their 
common prefix. 

(Financial: credit card number validation) Rewrite Exercise 6.29 using a string 
input for a credit card number. 

**8.I5 

(Business: check ISBN-10) An ISBN-10 (International Standard Book Number) 
consists of 10 digits: did 2 d^di,dsd(,d-id^dqdiQ. The last digit, diQ, is a checksum, 
which is calculated from the other nine digits using the following formula: 

X 1 + ^2 X 2 + ^3 X 3 + X 4 + ^5 X 5 
+ 4 X 6 + t /7 X 7 + dg X 8 + rfg X 9) % 11 

If the checksum is 10, the last digit is denoted as X, according to the ISBN con¬ 
vention. Write a program that prompts the user to enter the first 9 digits as a string 
and displays the 10-digit ISBN (including leading zeros). Your program should 
read the input as a string. Here are sample runs: 


Enter the first 9 digits of an ISBN-10 as a string: 

013601267 

The ISBN-10 number is 0136012671 



Enter the first 9 digits of an ISBN-10 as a string: 

013031997 

The ISBN-10 number is 013031997X 

**8.I6 

(Business: check ISBN-13) ISBN-13 is a new standard for identifying books. It 
uses 13 digits: The last digit, <^ 13 , is a checksum, 

which is calculated from the other digits using the following formula: 

10 ~ (di -H 3^2 -r dj + 3^4 + ^5 + 3dg + d^ + 3dg + dg + 3d^Q + dn + 3dj2) % 10 

If the checksum is 10, replace it with 0. Your program should read the input as a 
string. Here are sample runs: 


Enter the first 12 digits of an ISBN-13 as a string: 

978013213080 pTnter| 

The ISBN-13 number is 9780132130806 
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Enter the first 12 d igits of an ISBN-13 as a string: 
978013213079 

The ISBN-13 number is 9780132130790 



Section 8.6 

**8.1 7 {The Point class) Design a class named Poi nt to represent a point with x- and y- 
coordinates. The class contains: 

■ Two private data fields x and y that represent the coordinates with get methods. 

■ A constructor that constructs a point with specified coordinates with default 
point ( 0 , 0 ). 

■ A method named distance that returns the distance from this point to another 
point of the Point type. 

■ A method named isNearByCpl) that returns true if point pi is close to this 
point. Two points are close if their distance is less than 5. 

■ Implement the_ str _ method to return a string in the form (x, y). 

Draw the UML diagram for the class, and then implement the class. Write a test 
program that prompts the user to enter two points, displays the distance between 
them, and indicates whether they are near each other. Here are sample runs: 


Enter two points xl, yl, x2, y2: 2.1, 2.3, 19.1, 19.2 Enter 
The distance between the two points is 23.97 
The two points are not near each other 



Enter two points xl, yl, x2, y2: 2.1, 2.3, 2.3, 4.2 ^mer 
The distance between the two points is 1.91 
The two points are near each other 


*8.18 {Geometry: The CircleZD class) Define the Ci rcl e2D class that contains: 

■ Two private float data fields named x and y that specify the center of the circle 
with get/set methods. 

■ A private data field radius with get/set methods. 

■ A constructor that creates a circle with the specified x, y, and radius. The 
default values are all 0. 

■ A method getAreaC) that returns the area of the circle. 

■ A method getPerimeter C) that returns the perimeter of the circle. 

■ A method contai nsPoi nt (x, y) that returns True if the specified point (x, 
y) is inside this circle (see Figure 8.10a). 

■ A method contai ns (ci rcl e2D) that returns True if the specified circle is 
inside this circle (see Figure 8.10b). 

■ A method overlapsCcircle2D) that returns True if the specified circle 
overlaps with this circle (see Figure 8.10c). 

■ Implement the ^contains_(another) method that returns True if this 

circle is contained in another circle. 
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■ Implement the __cmp_ ,_ It_ ,_ le_ ,_ eq_ ,_ ne_ ,_ gt. 

_ge_ methods that compare two circles based on their radius. 



Figure 8.10 (a) A point is inside the circle, (b) A circle is inside another circle, (c) A circle 

overlaps another circle. 


Draw the UML diagram for the class, and then implement the class. Write a test 
program that prompts the user to enter two circles with x- and y-coordinates and the 
radius, creates two CircleZD objects cl and c2, displays their areas and perime¬ 
ters, and displays the result of cl.containsPointCcZ .getXC) , c2 .getY()), 
cl.containsCc2), and cl.overlapsCc2). Here is a sample run: 


Enter xl, yl, radiusl: 5, 5.5, 10 
Enter x2, y2, radius2: 9, 1.3, 10 Ente^ 
Area for cl is 314.1592653589793 
Perimeter for cl is 62.83185307179586 
Area for c2 is 314.1592653589793 
Perimeter for c2 is 62.83185307179586 
cl contains the center of c2? True 
cl contains c2? False 
cl overlaps c2? True 


*8.19 {Geometry: The RectangleZD class) Define the RectangleZD class that 

contains: 

■ Two float data fields named x and y that specify the center of the rectangle 
with get/set methods. (Assume that the rectangle sides are parallel to x- or y- 
axes.) 

■ The data fields width and height with get/set methods. 

■ A constructor that creates a rectangle with the specified x, y, width, and 
height with default values 0. 

■ A method getAreaC) that returns the area of the rectangle. 

■ A method getPerimeterC) that returns the perimeter of the rectangle. 

■ A method containsPoint(x, y) that returns True if the specified point (x, 
y) is inside this rectangle (see Figure 8.1 la). 

■ A method containsCRectang! e2D) that returns True if the specified 
rectangle is inside this rectangle (see Figure 8.1 lb). 

■ A method overlapsCRectang1e2D) that returns True if the specified 
rectangle overlaps with this rectangle (see Figure 8.1 Ic). 

■ Implement the ^contains_(another) method that returns True if this 

rectangle is contained in another rectangle. 

■ Implement the _ciiip_ ,_ It_ ,_ le_ ,_ eq_ ,_ ne__,_gt_ , 

_ ge _methods that compare two circles based on their areas. 






Programming Exercises 269 


p 


(a) (b) (c) 

Figure 8. II (a) A point is inside the rectangle, (b) A rectangle is inside another rectangle, 
(c) A rectangle overlaps another rectangle. 

Draw the UML diagram for the class, and then implement the class. Write a test pro¬ 
gram that prompts the user to enter two rectangles with center x-, y-coordinates, 
width, and height, creates two Rectangl e2D objects rl and r2, displays their areas 
and perimeters, and displays the result of rl.containsPoint(r2.getXC), 
r2 .getYO), rl.contains(r2), and rl.overlapsCr2). Here is a sample run: 


Enter xl, yl, widthl, heightl: 9, 1.3, 10, 35.3 |^Enter 

Enter x2, y2, width2, height2: 1.3, 4.3, 4, 5.3 Enter 

Area for rl is 353.0 

Perimeter for rl is 90.6 

Area for r2 is 21.2 

Perimeter for r2 is 18.6 

rl contains the center of r2? False 

rl contains r2? False 

rl overlaps r2? False 



8.20 {Use the Rational class) Write a program that computes the following summa¬ 
tion series using the Rational class: 

1 2 3 8 9 

— -F — -F — -F ... -F — -F — 

2 3 4 9 10 

*8.21 {Math: The Complex class) Python has the complex class for performing com¬ 
plex number arithmetic. In this exercise, you will design and implement your own 
Compi ex class. Note that the comp1 ex class in Python is named in lowercase, but 
our custom Compi ex class is named with C in uppercase. 

A complex number is a number of the form a + bi, where a and b are real numbers 
and i is V—1. The numbers a and b are known as the real part and the imaginary 
part of the complex number, respectively. You can perform addition, subtraction, 
multiplication, and division for complex numbers using the following formulas: 

{a + bi) + (c + di) = {a + c) + {b + d)i 

a + bi — {c + di) = {a — c) + {b — d)i 

{a + bi)*{c + di) = {ac — bd) + {be + ad)i 

{a + bi)/{c + di) = {ac + bd)/{c^ + d^) + {be — ad)il{c^ + d^) 

You can also obtain the absolute value for a complex number using the following 
formula: 

\a + bi\ = \/a^ + b^ 

(A complex number can be interpreted as a point on a plane by identifying the {a,b) 
values as the coordinates of the point. The absolute value of the complex number 
corresponds to the distance of the point to the origin, as shown in Figure 8.12.) 
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y-axis 



Figure 8.12 Point (2, 3) can be written as a complex number (2 + 3i) and (3, —2) as 
(3 - 20. 

Design a class named Comp1 ex for representing complex numbers and the meth¬ 
ods _add_ ,_ sub_ , _mul_ ,_ truediv _ , and _abs_ for per¬ 
forming complex-number operations, and override the _ str _ method by 

returning a string representation for a complex number. The_ str_ method 

returns (a -I- bi) as a string. If b is 0, it simply returns a. 

Provide a constructor Comp1 ex (a, b) to create a complex number a + bi with 
the default value of 0 for a and b. Also provide the getReal Part() and 
getImaginaryPartO methods for returning the real and imaginary parts of the 
complex number, respectively. 

Write a test program that prompts the user to enter two complex numbers and dis¬ 
plays the result of their addition, subtraction, multiplication, and division. Here is 
a sample run: 



Enter the first complex number: 3.5, 6.5 I ^ Enter] 

Enter the second complex number: -3.5, 1 [ ^ Enter | 

(3.5 + 6.5i) + (-3.5 + li) = (0.0 + 7.5i) 

(3.5 + 6.5i) - (-3.5 + li) = (7.0 -h 5.5i) 

(3.5 + 6.5i) * (-3.5 + li) = (-18.75 - 19.25i) 

(3.5 + 6.5i) / (-3.5 + li) = (-0.43396226415 - 1.98113207547i) 

1(3.5 + 6.5i)| = 4.47213595499958 
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9 

GUI Programming 
Using Tkinter 

objectives 

■ To create a simple GUI application with Tkinter (§9.2). 

■ To process events by using callback functions that are bound to a widget’s 
command option (§9.3). 

■ To use labels, entries, buttons, check buttons, radio buttons, messages, and 
text to create graphical user interfaces (§9.4). 

■ To draw lines, rectangles, ovals, polygons, and arcs and display text strings 
in a canvas (§9.5). 

■ To use geometry managers to lay out widgets in a container (§9.6). 

■ To lay out widgets in a grid by using the grid manager (§9.6.1). 

■ To pack widgets side by side or on top of each other by using the pack 
manager (§9.6.2). 

■ To place widgets in absolute locations by using the place manager (§9.6.3). 

■ To achieve a desired layout by using containers to group widgets (§9.7). 

■ To use images in widgets (§9.8). 

■ To create applications that contain menus (§9.9). 

■ To create applications that contain popup menus (§9.10). 

■ To bind a widget’s mouse and key events to a callback function for 
processing events (§9.11). 

■ To develop animations (§9.12). 

■ To use scroll bars to scroll through the contents of a text widget (§9.13). 

■ To use standard dialog boxes to display messages and accept user input 
(§9.14). 
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V' / Point 


9.1 Introduction 

Tkinter enables you to develop GUI programs and is an excellent pedagogical tool for 
learning object-oriented programming. 


There are many GUI modules available for developing GUI programs in Python. You have 
used the turtle module for drawing geometric shapes. Turtle is easy to use and is an 
effective pedagogical tool for introducing the fundamentals of programming to beginners. 
However, you cannot use turtle to create graphical user interfaces. This chapter introduces 
what is Tkinter? Tkinter, which will enable you to develop GUI projects. Tkinter is not only a useful tool for 

developing GUI projects, but it is also a valuable pedagogical tool for learning object- 
oriented programming. 



Note 

Tkinter (pronounced T-K-Inter) is short for “Tk interface.” Tk is a GUI library used by 
many programming languages for developing GUI programs on Windows, Mac, and 
UNIX. Tkinter provides an interface for Python programmers to use the Tk GUI library, 
and it is the de-facto standard for developing GUI programs in Python. 


rr/Key 
} Point 


9.2 Getting Started with Tkinter 

The tkinter module contains the classes for creating GUIs. The Tk class creates a 
window for holding GUI widgets (i.e., visual components). 


Listing 9.1 introduces Tkinter with a simple example. 


create a window 
create a label 
create a button 
place label 
place button 

event loop 


Listing 9.1 SimpleGUI.py 

1 from tkinter import * # Import all definitions from tkinter 

2 

3 window = Tk() # Create a window 

4 label = Label(window, text = "Welcome to Python") # Create a label 

5 button = Buttonfwindow, text = "Click Me") # Create a button 

6 label.packO # Place the label in the window 

7 button.packO # Place the button in the window 

8 

9 window.mainloopO # Create an event loop 


When you run the program, a label and a button appear in the Tkinter window, as shown in 
Figure 9.1. 



Figure 9.1 The label and button are created in Listing 9.1. 


Whenever you create a GUI-based program in Tkinter, you need to import the tkinter 
module (line 1) and create a window by using the Tk class (line 3). Recall that the asterisk (*) in 
line 1 imports all definitions for classes, functions, and constants from the tkinter module to 
the program.TkC) creates an instance of a window. Label and Button are Python Tkinter 
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widget classes for creating labels and buttons. The first argument of a widget class is always the 
parent container (i.e., the container in which the widget will be placed). The statement (line 4) 

label = Label(window, text = ''Welcome to Python") 

constructs a label with the text Wei come to Python that is contained in the window. 

The statement (line 6) 

1 abel . packO 

places 1 abel in the container using a pack manager. In this example, the pack manager packs 
the widget in the window row by row. More on the pack manager will be introduced in 
Section 9.6.2. For now, you can use the pack manager without knowing its full details. 

Tkinter GUI programming is event driven. After the user interface is displayed, the pro¬ 
gram waits for user interactions such as mouse clicks and key presses. This is specified in the 
following statement (line 9) 

window.mat nloop() 

The statement creates an event loop. The event loop processes events continuously until 
you close the main window, as shown in Figure 9.2. 



Figure 9.2 A Tkinter GUI program listens and processes events in a continuous loop. 


9.1 What are turtle and Tkinter suitable for? 

9.2 How do you create a window? 

9.3 What is wi ndow. mai nl oop() for? 

9.3 Processing Events 

A Tkinter widget can be bound to a function, which is called when an event occurs. 

The Button widget is a good way to demonstrate the basics of event-driven programming, so 
weTl use it in the following example. 

When the user clicks a button, your program should process this event. You enable this 
action by defining a processing function and binding the function to the button, as shown in 
Listing 9.2. 


widget class 
parent container 


Jcheck 
W Point 

MyProgrammingLab" 


^/Key 
y; Point 



VideoNote 


Simple GUI 
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process OK 

process Cancel 

create a window 
create a button 
create a button 

place button 
place button 

event loop 


callback functions 
handlers 


initialize GUI 
create a button 
create a button 


GUI Programming Using Tkinter 

Listing 9.2 ProcessButtonEvent.py 

1 from tkinter import * # Import ail definitions from tkinter 

2 

3 def processOKC): 

4 printC'OK button is clicked”) 

5 

6 def processCancel(): 

7 pri ntC'Cancel button is clicked') 

8 

9 window = Tk() # Create a window 

10 btOK = Button(window, text = "OK", fg = "red' , command = processOK) 

11 btCancel = Button(window, text = 'Cancel", bg = "yellow", 

12 command = processCancel) 

13 btOK.packO # Place the OK button in the window 

14 btCancel.packO # Place the Cancel button in the window 

15 

16 wi ndow. mai nl oopO # Create an event loop 

When you run the program, two buttons appear, as shown in Figure 9.3a. You can watch 
the events being processed and see their associated messages in the command window in 
Figure 9.3b. 



SB Administrator Command Prompt - python ProcessButtonEvent.py 

.,.Jn|x| 

c :\pt/book>pi/thon Pi*ocessButtonEvent. pp 

OK button is clicked 


Cancel button is clicked 

A 

<1 1 



(a) (b) 

Figure 9.3 (a) Listing 9.2 displays two buttons in a window, (b) Watching events being 

processed in the command window. 


The program defines the functions processOK and processCancel (lines 3-7). These 
functions are bound to the buttons when the buttons are constructed. These functions are 
known as callback functions, or handlers. The following statement (line 10) 

btOK = Button(window, text = "OK", fg = "red', command = processOK) 

binds the OK button to the processOK function, which will be called when the button is 
clicked. The fg option specifies the button’s foreground color and the bg option specifies its 
background color. By default, fg is black and bg is gray for all widgets. 

You can also write this program by placing all the functions in one class, as shown in 
Listing 9.3. 


Listing 9.3 ProcessButtonEventAlternativeCode.py 

1 from tkinter import * # Import all definitions from tkinter 

2 

3 class ProcessButtonEvent: 

4 def _init_(self): 

5 window = Tk() # Create a window 

6 btOK = Button(window, text = "OK”, fg = "red", 

7 command = self.processOK ) 

8 btCancel = Button(window, text = "Cancel'', bg = "yellow", 

9 command = self.processCancel) 
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10 btOK.packO # Place the OK button In the window 

11 btCancel.packO # Place the Cancel button in the window 

12 

13 window.mainloopO # Create an event loop 

14 

15 def processOK(self): 

16 printC'OK button is clicked") 

17 

18 def processCancel(self): 

19 pri ntC'Cancel button is clicked") 

20 

21 ProcessButtonEventO # Create an object to invoke_init_method 


place button 
place button 

event loop 

process OK 

process Cancel 


The program defines a class for creating the GUI in the_ init_ method (line 4). The 

functions processOK and processCancel are now instance methods in the class, so they 
are called by sel f. processOK (line 7) and sel f. processCancel (line 9). 

There are two advantages of defining a class for creating a GUI and processing GUI 
events. First, you can reuse the class in the future. Second, defining all the functions as meth¬ 
ods enables them to access instance data fields in the class. 


9.4 


9.5 


When you create a widget object from a widget class, what should be the first 
argument? 

What is a widget’s command option for? 


^tteck 
W Point 

MyProgrammingLab" 


9.4 The Widget Classes 

Tkinter’s GUI classes define common GUI widgets such as buttons, labels, radio 
buttons, check buttons, entries, canvases, and others. 

Table 9.1 describes the core widget classes Tkinter provides. 


Key 
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Table 9.1 Tkinter Widget Classes 

Widget Class Description 


Button 

Canvas 

Checkbutton 

Entry 

Frame 

Label 

Menu 

Menubutton 

Message 

Radiobutton 

Text 


A simple button, used to execute a command. 

Structured graphics, used to draw graphs and plots, create graphics editors, and implement custom widgets. 
Clicking a check button toggles between the values. 

A text entry field, also called a text field or a text box. 

A container widget for containing other widgets. 

Displays text or an image. 

A menu pane, used to implement pull-down and popup menus. 

A menu button, used to implement pull-down menus. 

Displays a text. Similar to the label widget, but can automatically wrap text to a given width or aspect ratio. 

Clicking a radio button sets the variable to that value, and clears all other radio buttons associated with the same 
variable. 

Formatted text display. Allows you to display and edit text with various styles and attributes. Also supports 
embedded images and windows. 


There are many options for creating widgets from these classes. The first argument is 
always the parent container. You can specify a foreground color, background color, font, and 
cursor style when constructing a widget. 
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color 


font 


text formatting 


mouse cursor 


change properties 


create a window 
window title 

create frame 


To specify a color, use either a color name (such as red, yellow, green, blue, white, black, 
purple) or explicitly specify the red, green, and blue (RGB) color components by using a 
string #RRCGBB, where RR, CG, and BB are hexadecimal representations of the red, green, and 
blue values, respectively. 

You can specify a font in a string that includes the font name, size, and style. Here are 
some examples: 

Times 10 bold 
Helvetica 10 bold italic 
CourierNew 20 bold italic 

Courier 20 bold italic overstrike underline 

By default, the text in a label or a button is centered. You can change its alignment by 
using the justify option with the named constants LEFT, CENTER, or RIGHT. (Remember, 
as discussed in Section 2.6, named constants are in all uppercase.) You can also display the 
text in multiple lines by inserting the newline character \n to separate lines of text. 

You can specify a particular style of mouse cursor by using the cursor option with string 
values such as arrow (the default), ci rcl e, cross, pi us, or some other shape. 

When you construct a widget, you can specify its properties such as fg, bg, font, 
cursor, text, and command in the constructor. Later in the program, you can change the 
widget’s properties by using the following syntax: 

widgetName ["propertyName’ ] = newPropertyValue 

For example, the following code creates a button and its text property is changed to 
Hide, bg property to red, and fg to #AB84F9. #AB84F9 is a color specified in the form of 
RRGGBB. 

btShowOrHide = Button(window, text = ''Show”, bg = "white') 
btShowOrHide[ 'text' ] = "Hide" 
btShowOrHide["bg' ] = "red" 

btShowOrHide[ "fg' ] = "#AB84F9" # Change fg color to #AB84F9 
btShowOrHide ["cursor"] = "plus" # Change mouse cursor to plus 
btShowOrHide[ "justify"] = LEFT # Set justify to LEFT 

Each class comes with a substantial number of methods. The complete information about 
these classes is beyond the scope of this book. A good reference resource for Tkinter can be 
found at www.pythonware.com/library/tkinter. This chapter provides examples that show you 
how to use these widgets. 

Listing 9.4 is an example of a program that uses the widgets Frame, Button, 
Checkbutton, Radiobutton, Label, Entry (also known as a text field). Message, and 
Text (also known as a text area). 

Listing 9.4 Wi dgetsDemo. py 

1 from tkinter import * # Import all definitions from tkinter 

2 

3 class WidgetsDemo: 

4 def _init_(self): 

5 window = Tk() # Create a window 

6 window. titleC'Widgets Demo") # Set a title 

7 

8 # Add a check button, and a radio button to framel 

9 framel = Frame(window) # Create and add a frame to window 

10 framel. packO 

11 self.vl = IntVarO 
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12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 

60 
61 


cbtBold = Checkbutton(framel, text = 'Bold", 

variable = self.vl, command = self.processCheckbutton) 
self.v2 = IntVarO 

rbRed = Radiobutton(framel, text = Red", bg = 'red", 
variable = self.v2 , value = 1_ 
command = self.processRadiobutton) 
rbYellow = Radiobutton(framel, text = "Yellow", 

bg = "yellow", variable = self.v2, value = 2, 
command = self.processRadiobutton) 
cbtBold.grid(row = 1, column = 1) 
rbRed.grid(row = 1, column = 2) 
rbYellow.grid(row = 1, column = 3) 

# Add a label, an entry, a button, and a message to framel 
frame2 = Frame(window) # Create and add a frame to window 
frame2.pack() 

label = Label(frame2, text = "Enter your name: ") 
self.name = StringVarO 

entryName = Entry(frame2, textvariable = self.name) 
btCetName = Button(frame2, text = "Get Name", 
command = self.processButton) 
message = Message(frame2, text = "It is a widgets demo") 
label.grid(row = 1, column = 1) 
entryName.grid(row = 1, column = 2) 
btCetName.grid(row = 1, column = 3) 
message.grid(row = 1, column = 4) 

# Add text 

text = Text(window) # Create and add text to the window 

text. packO 

text.insert(END, 

"Tip\nThe best way to learn Tkinter is to read ") 

text.insert(END, 

"these carefully designed examples and use them ") 
text.insert(END, "to create your applications.") 

window.mainloopO # Create an event loop 

def processCheckbutton(self): 
printC'check button is " 

+ ("checked " if self.vl.getO == 1 else "unchecked")) 

def processRadiobutton(self): 

pri nt(( if self. v2 .get() == 1 else "Yellow") 

+ " is selected " ) 

def processButton(self): 

printC'Your name is " + self.name.get()) 

WidgetsDemoO # Create GUI 


create check button 


create radio button 


grid manager 


create frame 


create entry 


create message 


create text 
insert text 


event loop 

check button status 

radio button status 

entry name 
create GUI 


When you run the program, the widgets are displayed as shown in Figure 9.4a. As you 
click the Bold button, select the Yellow radio button, and type in “Johnson,” you can watch 
the events being processed and see their associated messages in the command window in 
Figure 9.4b. 

The program creates the window (line 5) and invokes its titl e method to set a title (line 
6 ). The Frame class is used to create a frame named framel and the parent container for the 
frame is the window (line 9). This frame is used as the parent container for a check button and 
two radio buttons, created in lines 12, 15, and 18. 
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7^ Widgets Demo 





Enter your name: 


Red (• Yellow 


I ft is a 

Get Name | widgets 
demo 

I Tip 

The best way to learr. Tkir.ter is to read 
these uareTully desxy::ed exaii4;les ar^d use 
them to create your applications. 


tai Administrator Command Prompt - python WidqetsDemo.py 


|c :\pybook>python UidgetsDeno .pp 



check button is checked 

— 


Yellow is selected 



Your nane is Johnson 



r<\ 1 




(a) (b) 

Figure 9.4 (a) The widgets are displayed in the user interface, (h) Watching events being processed. 


IntVar 
DoubleVar 
StringVar 


geometry manager 


window title 


create frame 1 
create label 


You use an entry (text field) for entering a value. The value must be an object of IntVar, 
Doubl eVar, or Stri ngVar representing an integer, a float, or a string, respectively. IntVar, 
Doubl eVar, and Stri ngVar are defined in the tkinter module. 

The program creates a check button and associates it with the variable vl. vl is an 
instance of IntVar (line 11). vl is set to 1 if the check button is checked, or 0 if it isn’t 
checked. When the check button is clicked. Python invokes the processCheckbutton 
method (line 13). 

The program then creates a radio button and associates it with an IntVar variable, v2. v2 
is set to 1 if the Red radio button is selected, or 2 if the Yellow radio button is checked. You 
can define any integer or string values when constructing a radio button. When either of the 
two buttons is clicked, the processRadiobutton method is invoked. 

The grid geometry manager is used to place the check button and radio buttons into 
framel. These three widgets are placed in the same row and in columns 1, 2, and 3, respec¬ 
tively (lines 21-23). 

The program creates another frame, f ranie2 (line 26), for holding a label, an entry, a button, 
and a message widget. Like framel, frame2 is placed inside the window. 

An entry is created and associated with the variable name of the Stri ngVar type for stor¬ 
ing the value in the entry (line 29). When you click the Get Name button, the processButton 
method displays the value in the entry (line 59). The Message widget is like a label except that 
it automatically wraps the words and displays them in multiple lines. 

The grid geometry manager is used to place the widget in frame2. These widgets are 
placed in the same row and in columns 1, 2, 3, and 4, respectively (lines 34-37). 

The program creates a Text widget (line 40) for displaying and editing text. It is placed 
inside the window (line 41). You can use the insert method to insert text into this widget. 
The END option specifies that the text is inserted into the end of the current content. 

Listing 9.5 is a program that lets the user change the color, font, and text of a label, as 
shown in Figure 9.5. 

Listing 9.5 ChangeLabel Demo. py 

1 from tkinter import * # Import ail definitions from tkinter 

2 

3 class ChangeLabelDemo: 

4 def _ init_(self): 

5 window = Tk() # Create a window 

6 window.title ("Change Label Demo") # Set a title 

7 

8 # Add a label to framel 

9 framel = Frame(window) # Create and add a frame to window 

10 framel. packO 

11 self.lbl = Label(framel, text = "Programming is fun") 

12 self.lbl .packO 

13 
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14 

# Add a label, entry, button, two radio buttons to frame2 


15 

frame2 = Frame(window) # Create and add a 

frame to window 

create frame! 

16 

frame2.pack() 



17 

label = Label(frame2, text = "Enter text: 

") 


18 

self.msg = StringVarO 



19 

entry = Entry(frame2, textvariable = self, 

.msg) 

create entry 

ZO 

btChangeText = Button(frame2, text = "Change Text", 


Z1 

command = self.processButton) 


button callback 

Z2 

self.vl = StringVarO 



23 

rbRed = Radiobutton(frame2, text = Red", 

bg = "red". 


24 

variable = self.vl, value = 'R', 



25 

command = self.processRadiobutton) 


radio button callback 

26 

rbYellow = Radiobutton(frame2, text = "Yellow", 


27 

bg = "yellow", variable = self.vl, value = 'Y' , 


28 

command = self.processRadiobutton) 


radio button callback 

29 




30 

label.grid(row = 1, column = 1) 



31 

entry.grid(row = 1, column = 2) 



32 

btChangeText.gridfrow = 1, column = 3) 



33 

rbRed.grid(row = 1, column = 4) 



34 

rbYellow.grid(row = 1, column = 5) 



35 




36 

window.mainloopO # Create an event loop 


event loop 

37 




38 

def processRadiobutton(self): 



39 

if self .vl.getO == 'R' : 



40 

sel f. 1 bl [ 'fg' ] = "red" 


set a new fg 

41 

elif self.Vl.getO == 'Y' : 



42 

self.lbl[ 'fg' ] = "yellow" 


set a new fg 

43 




44 

def processButton(self): 



45 

self .Ibl ['text' ] = self .msg.getO # New text for the label 

set new text 

46 




47 

ChangeLabelDemoO # Create GUI 


create GUI 


Good morning 

Entertext; Good morning| ChangeText 


Yellow 


Figure 9.5 The program changes the label’s text and fg properties dynamically. 


When you select a radio button, the label’s foreground color changes. If you enter new text 
in the entry field and click the Change Text button, the new text appears in the label. 

The program creates the window (line 5) and invokes its title method to set a title 
(line 6 ). The Frame class is used to create a frame named f ramel and the parent container for 
the frame is the window (line 9). This frame is used as the parent container for a label created 
in line 11. Because the label is a data field in the class, it can be referenced in a callback 
function. 

The program creates another frame, f rameZ (line 15), for holding a label, an entry, a button, 
and two radio buttons. Like f ramel, f rameZ is placed inside the window. 

An entry is created and associated with the variable msg of the StringVar type for storing 
the value in the entry (line 19). When you click the Change Text button, the processButton 
method sets a new text entry for the label in f ramel, using the text in the entry (line 45). 
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Two radio buttons are created and associated with a StringVar variable, v2. v2 is set to 
R if the Red radio button is selected, or to Y if the Yellow radio button is clicked. When the user 
clicks either of the two buttons. Python invokes the processRadiobutton method to 
change the label’s foreground color in f ramel (lines 38^2). 


iCheck 
W Point 

9.6 

How do you create a label with the text Wei come, a white foreground, and a red back¬ 
ground? 

MyProgrammingLab' 

9.7 

How do you create a button with the text OK, a white foreground, a red background, 
and with the callback function processOK? 


9.8 

How do you create a check button with the text appl e, a white foreground, a red 
background, associated with the variable vl, and with the callback function 

processApple? 


9.9 

How do you create a radio button with the text senior, a white foreground, a red 
background, associated with the variable vl, and with the callback function 

processSenior? 


9.10 

How do you create an entry with a white foreground, a red background, and associ¬ 
ated with the variable vl? 


9.11 

How do you create a message with the text programming is fun, a white fore¬ 
ground, and a red background? 


9.12 

LEFT, CENTER, and RIGHT are named constants defined in the tkinter module. 
Use a print statement to display the values defined by LEFT, CENTER, and 
RIGHT. 


9.5 Canvas 


•P / Point 


You use the Canvas widget for displaying shapes. 

You can use the methods create_rectangle, create_oval, create_arc, 
create_polygon, or create_line to draw a rectangle, oval, arc, polygon, or line on a 
canvas. 

Listing 9.6 shows how to use the Canvas widget. The program displays a rectangle, an 
oval, an arc, a polygon, a line, and a text string. The objects are all controlled by buttons, as 
shown in Figure 9.6. 


create a window 


create a canvas 


create a frame 
create buttons 


Listing 9.6 CanvasDemo.py 

1 from tkinter import * # Import ail definitions from tkinter 

2 

3 class CanvasDemo: 

4 def _init_(self): 

5 window = Tk() # Create a window 

6 window. titleC'Canvas Demo") # Set title 

7 

8 # Place canvas in the window 

9 self.canvas = Canvas(window, width = 200, height = 100, 

10 bg = white") 

11 self .canvas.packO 

12 

13 # Place buttons in frame 

14 frame = Framefwindow) 

15 frame. packO 

16 btRectangle = Button(frame, text = Rectangle", 

17 command = self.displayRect) 


18 

19 

20 

21 

22 

23 

24 

25 

26 

27 
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btOval = Button(frame, text = "Oval", 
command = self.displayOval) 
btArc = Button(frame, text = "Arc", 
command = self.displayArc) 
btPolygon = Button(frame, text = "Polygon", 
command = self.displayPolygon) 
btline = Button(frame, text = "Line", 
command = self.displayLine) 
btString = Button(frame, text = "String", 
command = self.displayString) 
btClear = Button(frame, text = "Clear", 
command = self.clearCanvas) 
btRectangle.grid(row = 1, column = 1) 
btOval.grid(row = 1, column = 2) 
btArc.grid(row = 1, column = 3) 
btPolygon.grid(row = 1, column = 4) 
btLine.grid(row = 1, column = 5) 
btString.grid(row = 1, column = 6) 
btClear.grid(row = 1, column = 7) 

window.mainloopO # Create an event loop 

# Display a rectangle 

def displayRect(self): 

self.canvas. create_rectangle(10, 10, 190, 90, tags = 'rect' ) 

# Display an oval 

def displayOval(self): 

self.canvas.create_oval (10, 10, 190, 90, fill = "red", 
tags = oval') 

# Display an arc 

def displayArc(self): 

self.canvas. create_arc(10, 10, 190, 90, start = 0, 

extent = 90, width = 8, fill = "red' , tags = 'arc') 

# Display a polygon 

def displayPolygon(self): 

self.canvas.create_polygon (10, 10, 190, 90, 30, 50, 
tags = 'polygon') 

# Display a line 

def displayLine(self): 

self.canvas. create_line(10, 10, 190, 90, fill = "red", 
tags = "line") 

self.canvas. create_line(10, 90, 190, 10, width = 9, 

arrow = "last", activefill = "blue", tags = "line") 

# Display a string 

def displayString(self): 

self.canvas. create_text(60, 40, text = 'Hi, I am a string", 
font = "Times 10 bold underline' , tags = "string') 

# Clear drawings 

def clearCanvas(self): 

self .canvas. delete('rect", "oval", "arc", "polygon", 

"line", "string') 


place buttons 


event loop 


display rectangle 


display oval 


display arc 


display polygon 


display line 


display string 


clear canvas 


CanvasDemoO # Create GUI 


create GUI 
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grid manager 


coordinate system 


create_text 




Rectangle Oval Arc Polygon Line String Clear 



P 



Rectangle Oval Arc Polygon Line String Clear 




Figure 9.6 The geometrical shapes and strings are drawn on the canvas. 


The program creates a window (line 5) and sets its title (line 6). A Canvas widget is cre¬ 
ated within the window with a width of 200 pixels, a height of 100 pixels, and a background 
color of white (lines 9-10). 

Seven buttons—labeled with the text Rectangle, Oval, Arc, Polygon, Line, String, and 
Clear —are created (lines 16-29). The grid manager places the buttons in one row in a frame 
(lines 30-36). 

To draw graphics, you need to tell the widget where to draw. Each widget has its own 
coordinate system with the origin (0, 0) at the upper-left corner. The x-coordinate increases to 
the right, and the y-coordinate increases downward. Note that the Tkinter coordinate system 
differs from the conventional coordinate system, as shown in Figure 9.7. 
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1 x-axis 


, _y-axis 
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Tkinter 

Coordinate 
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Conventional 

Coordinate 
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(0,0) 
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Figure 9.7 The Tkinter coordinate system is measured in pixels, with (0, 0) at its upper- 
left corner. 

The methods create_rectangle, create_oval, create_arc, create_polygon, 
and create_line (lines 42, 46, 51, 56, and 61) are used to draw rectangles, ovals, arcs, 
polygons, and lines, as illustrated in Figure 9.8. 

The create_text method is used to draw a text string (line 68). Note that the horizontal 
and vertical center of the text is displayed at (x, y) for create_text(x, y, text) as 
shown in Figure 9.8. 

All the drawing methods use the tags argument to identify the drawing. These tags are 
used in the delete method for clearing the drawing from the canvas (lines 73-74). 


tags 
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{x2, yi) 

canvas.create_rectangle(xl, y\, x2, y2) 


Gi,yi) 



(x2, y2) 

canvas.create_oval(xl, yl, x2, y2) 



canvas.create_arc(xl, yl, x2, y2, start, extent) 


(xTyi) 



{x2, y2) 



canvas.create_polygon(xl, yl, x2, y2, x3, y3) canvas.create_line(xl, yl, x2, y2) 
Figure 9.8 The Canvas class contains the methods for drawing graphics. 


ABODE 

t 

G. y) 


canvas.create_text(x, y, text = “ABODE”) 


The width argument can be used to specify the pen size in pixels for drawing the shapes width 
(lines 52 and 63). 

The arrow argument can be used with create_l ine to draw a line with an arrowhead arrow 
(line 64). The arrowhead can appear at the start, end, or both ends of the line with the argu¬ 
ment value fi rst, end, or both. 

The acti vef i n argument makes the shape change color when you move the mouse over acti vefi 11 
it (line 64). 


9.13 

9.14 

9.15 

9.16 

9.17 

9.18 

9.19 

9.20 


Write the code to draw a line from (34, 50) to (50, 90). 

Write the code to draw a rectangle centered at (70, 70) with a width of 100 and a 
height of 100. Fill the rectangle with the color red. 

Write the code to draw an oval centered at (70, 70) with a width of 200 and a height 
of 100. Fill the rectangle with red. 

Write the code to draw an arc with a starting angle of 30, with an extent angle of 45 
in a bounding rectangle with its upper-left corner at (10, 10) and bottom-right corner 
at (80, 80). 

Write the code to draw a polygon with points at (10, 10), (15, 30), (140, 10), and 
(10,100). Fill the shape with red. 

How do you draw a shape with a large pen size? 

How do you draw a line with an arrowhead? 

How do you make a shape change color when the mouse is moved over it? 


ilCTeck 
W Point 

MyProgrammingLab" 


9.6 The Geometry Managers 

Tkinter uses a geometry manager to place widgets inside a container. 

Tkinter supports three geometry managers: the grid manager, the pack manager, and the place 
manager. You have already used the grid and pack managers. This section describes these 
managers and introduces some additional features. 


tr/Key 

Point 



Tip 

Since each manager has its own style of placing the widget, it is not a good practice to 
mix the managers for the widgets in the same container. You can use a frame as a sub¬ 
container to achieve the desired layout. 











284 Chapter 9 GUI Programming Using Tkinter 


rowspan 
columnspan 


rowspan 
padx 


sticky 
event loop 
create GUI 


sti cky option 
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pady option 


pack manager 
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fill 

expand 


9.6.1 The Grid Manager 

The grid manager places widgets into the cells of an invisible grid in a container. You can 
place a widget in a specified row and column. You can also use the rowspan and 
col umnspan parameters to place a widget in multiple rows and columns. Listing 9.7 uses the 
grid manager to lay out a group of widgets, as shown in Figure 9.9. 

Listing 9.7 GridManagerDemo. py 

1 from tkinter import * # Import all definitions from tkinter 

2 

3 class GridManagerDemo: 

4 window = Tk() # Create a window 

5 window.titl eC'Grid Manager Demo") # Set title 

6 

7 message = Messagefwindow, text = 

8 "This Message widget occupies three rows and two columns") 

9 message.gridfrow = 1, column = 1, rowspan = 3, columnspan = 2) 

10 Label(window, text = "First Name:") .grid(row = 1, column = 3) 

11 Entry(window).gridfrow = 1, column = 4, padx = 5, pady = 5) 

12 Label(window, text = "Last Name: ).grid(row = 2, column = 3) 

13 Entry(window).grid(row = 2, column = 4) 

14 Button(window, text = "Get Name") .grid(row = 3, 

15 padx = 5, pady = 5, column = 4, sticky = E) 

16 

17 window.mainloopO # Create an event loop 

18 

19 GridManagerDemoO # Create GUI 


Grid Manager 

This Message first Name: 

widget occupies Last Name: | 
three rows and 

I two columns Get Name 


Figure 9.9 The grid manager was used to place these widgets. 


The Message widget is placed in row 1 and column 1 and it expands to three rows and two 
columns (line 9). The Get Name button uses the sticky - E option (line 15) to stick to the 
east in the cell so that it is right aligned with the Entry widgets in the same column. The 
sticky option defines how to expand the widget if the resulting cell is larger than the widget 
itself. The sticky option can be any combination of the named constants S, N, E, and W, or 
NW, NE, SW, and SE. 

The padx and pady options pad the optional horizontal and vertical space in a cell (lines 
1 1 and 15). You can also use the i padx and i pady options to pad the optional horizontal and 
vertical space inside the widget borders. 

9.6.2 The Pack Manager 

The pack manager can place widgets on top of each other or place them side by side. You can 
also use the fill option to make a widget fill its entire container. 

Listing 9.8 displays three labels, as shown in Figure 9.10a. These three labels are packed 
on top of each other. The red label uses the option fill with value BOTH and expand with 
value 1. The fill option uses named constants X, Y, or BOTH to fill horizontally, vertically, or 
both ways. The expand option tells the pack manager to assign additional space to the widget 
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box. If the parent widget is larger than necessary to hold all the packed widgets, any extra 
space is distributed among the widgets whose expand option is set to a nonzero value. 


Listing 9.8 PackManagerDemo.py 

1 from tkinter import * # Import all definitions from tkinter 

2 

3 class PackManagerDemo: 

4 def _init_(self): 

5 window = Tk() # Create a window 

6 window.titl eC'Pack Manager Demo 1") # Set title 

7 

8 Label(window, text = 'Blue' , bg = "blue') .pack() 

9 Label(window, text = Red", bg = "red").pack( 

10 fill = BOTH, expand =1) 

11 Label(window, text = "Green", bg = "green") .pack( 

12 f i 11 = BOTH ) 

13 

14 window.mainloopO # Create an event loop 

15 

16 PackManagerDemoO # Create GUI 


*74 Pack Manager Demo 1 


■ 
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Green 



(a) 


71^ Pack Manager Demo 2 U O' i| 
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Red 
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Figure 9.10 (a) The pack manager uses the fill option to fill the container, (b) You can 

place widgets side by side. 


Listing 9.9 displays the three labels shown in Figure 9.10b. These three labels are packed 
side by side using the side option. The side option can be LEFT, RIGHT, TOP, or BOTTOM. 
By default, it is set to TOP. 


Listing 9.9 PackManagerDemoWi thSide. py 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 


from tkinter import * # Import all definitions from tkinter 

class PackManagerDemoWithSide: 

window = Tk() # Create a window 

window.titl eC'Pack Manager Demo 2") # Set title 

Label (window, text = 'Blue' , bg = "blue’’) .pack(side = LEFT) 
Label(window, text = Red", bg = 'red").pack( 
side = LEFT, fill = BOTH, expand = 1) 

Label(window, text = "Green", bg = "green" ).pack( 
side = LEFT, fill = BOTH) 

window.mainloopO # Create an event loop 


expand 

fill 

create GUI 


si de 


PackManagerDemoWithSide() # Create GUI 


create GUI 
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place manager 


pi ace 


create GUI 
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9.6.3 The Place Manager 

The place manager places widgets in absolute positions. Listing 9.10 displays the three labels 
shown in Figure 9.11. 

Listing 9.10 PIaceManagerDemo.py 

1 from tkinter import * # Import all definitions from tkinter 

2 

3 class PIaceManagerDemo: 

4 def _init_(self): 

5 window = Tk() # Create a window 

6 window.title ('Place Manager Demo") # Set title 

7 

8 Label(window, text = 'Blue", bg = 'blue") .place( 

9 X = 20, y = 20) 

10 Label(window, text = Red", bg = "red") .piace( 

11 X = 50, y = 50) 

12 Label(window, text = "Creen'L bg = "green") .piace( 

13 X = 80, y = 80) 

14 

15 window.mainloopO # Create an event loop 

16 

17 PIaceManagerDemoO # Create GUI 



Figure 9.11 The place manager places widgets in absolute positions. 


The upper-left corner of the blue label is at (20, 20). All three labels are placed using the 
place manager. 


Note 

The place manager is not compatible with all computers. If you run this program on Win¬ 
dows with a screen monitor with 1024 X 768 resolution, the layout size is just right. 

When the program is run on Windows with a monitor with a higher resolution, the com¬ 
ponents appear very small and clump together. When it is run on Windows with a mon¬ 
itor with a lower resolution, they cannot be shown in their entirety. Because of these 
incompatibility issues, you should generally avoid using the place manager. 

9.2 I What is wrong if you write the following code using the pack manager for a 
button? 

button.pack(LEFT) 

9.22 If you need to pad spaces between widgets, which geometry manager should you use? 

9.23 Why should you avoid using the place manager? 

9.24 X, Y, BOTH, S, N, E, and W, or NW, NE, SW, and SE are named constants defined in 
the tkinter module. Use a print statement to display the values defined in these 
constants. 
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9.7 Case Study: Loan Calculator 

This section provides an example that uses GUI widgets, geometry layout managers, 
and events. 

Listing 2.8 developed a console-based program for computing loans. This section develops a 
GUI application for computing loan payments, as shown in Figure 9.12a. 
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Figure 9.12 The program computes loan payments and provides a graphical user interface. 


Developing a GUI application involves designing the user interface and writing the code to 
process the events. Here are the major steps in writing the program: 

1. Design the user interface (UI) by drawing a sketch, as shown in Figure 9.12b. The UI 
consists of labels, text entry boxes, and a button. You can use the grid manager to posi¬ 
tion them in the window. 

2. Process the event. When the button is clicked, the program invokes a callback function 
to obtain the user input for the interest rate, number of years, and loan amount from the 
text entries, computes the monthly and total payments, and displays the values in the 
labels. 

Listing 9.11 shows the complete program. 

Listing 9.11 LoanCalculator.py 

1 from tkinter import * # Import all definitions from tkinter 

2 

3 class LoanCalculator: 

4 def _init_(self): 

5 window = Tk() # Create a window create window 

6 window.titl eC'Loan Calculator") # Set title 

7 

8 Label (wi ndow, text = "Annual Interest Rate") .grid(row = 1, create labels 

9 column = 1, sticky = W) 

10 Label(window, text = "Number of Years") .grid(row = 2, 

11 column = 1, sticky = W) 

12 Label(window, text = "Loan Amount") .grid(row = 3, 

13 column = 1, sticky = W) 

14 Label(window, text = "Monthly Payment") .grid(row = 4, 

15 column = 1, sticky = W) 

16 Label(window, text = "Total Payment") .grid(row = 5, 

17 column = 1, sticky = W) 

18 

19 self .annualInterestRateVar = StringVarO create entries 

20 Entry(window, textvariable = self.annualInterestRateVar, 

21 justify = RIGHT).grid(row = 1, column = 2) 

22 self.numberOfYearsVar = StringVarO 
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23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

create button 3 7 

callback 3 8 

39 

40 

41 

42 

computePayment 43 

44 

45 

46 

47 

set month! yPayment 48 

49 

50 

set total Payment 51 

52 

getMonthlyPayment 53 

54 

55 

56 

57 

58 

create GUI 59 


EntryCwindow, textvariable = self.numberOfYearsVar, 
justify = RIGHT).grid(row = 2, column = 2) 
self.loanAmountVar = StringVarO 
EntryCwindow, textvariable = self.loanAmountVar, 
justify = RIGHT).grid(row = 3, column = 2) 

self.monthlyPaymentVar = StringVarO 
1blMonthlyPayment = Label(window, textvariable = 

self.monthlyPaymentVar).gridCrow = 4, column = 2, 
sticky = E) 

self.totalPaymentVar = StringVarO 
1blTotalPayment = Label(window, textvariable = 
self.totalPaymentVar).gridCrow = 5, 
column = 2, sticky = E) 

btGomputePayment = Button(window, text = 'Compute Payment", 
command = self.computePayment).grid( 
row = 6, column = 2, sticky = E) 

window.mainloopO # Greate an event loop 

def computePaymentCself): 

monthlyPayment = self.getMonthlyPaymentC 
floatCsel f. 1 oanAmountVar. getO) , 
floatCself.annualInterestRateVar.getO) / 1200, 
int(self.numberOfYearsVar.get())) 
self.monthlyPaymentVar.set(format(monthlyPayment, "10 . 2f ")) 
totalPayment = float(self.monthlyPaymentVar.get()) * 12 \ 

* int(self.numberOfYearsVar.get()) 
self.totalPaymentVar.set(format(totalPayment, "10. 2f")) 

def getMonthlyPayment(self, 

loanAmount, monthlyInterestRate, numberOfYears): 
monthlyPayment = loanAmount * monthlyInterestRate / (1 

- 1 / (1 + monthlyInterestRate) ** (numberOfYears * 12)) 
return monthlyPayment; 

LoanGalculatorO # Greate GUI 


The program creates the user interface with labels, entries, and a button placed in the win¬ 
dow using the grid manager (lines 8-39). The command option for the button is set to the 
computePayment method (line 38). When the Compute Payment button is clicked, its 
method is invoked, which obtains the user input for the annual interest rate, years for the loan, 
and loan amount to calculate the monthly payment and total payment (lines 43-51). 


rr/Key 
C' ) Point 


The image file must be in GIF format. You can use a conversion utility to convert image 
files in other formats into GIF format. 

Listing 9.12 shows you how to add images to labels, buttons, check buttons, and radio but¬ 
tons. You can also use the create_image method to display an image in a canvas, as shown 
in Figure 9.13. 


9.8 Displaying Images 

You can add an image to a label, button, check button, or radio button. 
To create an image, use the Photoimage class as follows: 

photo = PhotoImage(fi1e = imagefi1ename) 
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Listing 9.12 ImageDemo. py 

1 from tkinter import * # Import all definitions from tkinter 

2 

3 class ImageDemo: 

4 def _init_(self): 

5 window = Tk() # Create a window 

6 window.titl eC'Tmage Demo") # Set title 

7 

8 # Create Photoimage objects 

9 calmage = PhotoImage(fi1e = image/ca.gif ) 

10 chinalmage = PhotoImage(fi1e = 'image/china.gif") 

11 leftimage = Photoimage(file = "image/1 eft.gif') 

12 rightimage = PhotoImage(fi1e = 'image/right.gif") 

13 usimage = PhotoImage(fi1e = 'image/usicon.gif") 

14 ukimage = PhotoImage(fi1e = "image/ukicon.gif") 

15 crossimage = PhotoImage(fi1e = "image/x.gif") 

16 circlelmage = PhotoImage(fi1e = "image/o.gif") 

17 

18 # framel to contain label and canvas 

19 framel = Frame(window) 

20 framel. packO 

21 Label(framel, image = calmage).pack(side = LEFT) 

22 canvas = Canvas(framel) 

23 canvas. create_image(30, 50, image = chinalmage) 

24 canvas[ 'width' ] = 200 

25 canvasE 'height' ] = 100 

26 canvas.pack(side = LEFT) 

27 

28 # frame2 contains buttons, check buttons, and radio buttons 

29 frame2 = Frame(window) 

30 f rame2. packO 

31 Button(frame2, image = 1eftimage).pack(side = LEFT) 

32 Button(frame2, image = rightimage).pack(side = LEFT) 

33 Checkbutton(frame2, image = usimage).pack(side = LEFT) 

34 Checkbutton(frame2, image = ukimage).pack(side = LEFT) 

35 Radiobutton(frame2, image = crossimage).pack(side = LEFT) 

36 Radiobutton(frame2, image = circlelmage).pack(side = LEFT) 

37 

38 window.mainloopO # Create an event loop 

39 

40 ImageDemoO # Create GUI 


create window 


create image 


image in label 
image in canvas 


image in button 
image in check button 
image in radio button 


create GUI 



Figure 9.13 The program displays widgets with images. 
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The program places image files in the image folder in the current program directory, then 
creates Photolmage objects for several images in lines 9-16. These objects are used in wid¬ 
gets. The image is a property in Label , Button, Checkbutton, and RadioButton (lines 21 
and 31-36). Image is not a property for Canvas, but you can use the create_image method 
to display an image on the canvas (line 23). In fact, you can display multiple images in one 



canvas. 
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9.9 


image = PhotoImageC'image/us.gif") 
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You can use Tkinter to create menus, popup menus, and toolbars. 

Tkinter provides a comprehensive solution for building graphical user interfaces. This section 
introduces menus, popup menus, and toolbars. 

Menus make selection easier and are widely used in windows. You can use the Menu class 
to create a menu bar and a menu, and use the add_conimand method to add items to the menu. 
Listing 9.13 shows you how to create the menus shown in Figure 9.14. 


Listing 9.13 MenuDemo.py 


1 

2 

3 

4 

5 

6 

7 

8 


create a menu bar 

9 

display menu bar 

10 


11 


12 

create a menu 

13 

display a menu 

14 

add menu item 

15 


16 


17 


18 


19 


20 


21 


22 


23 


24 


25 

create a menu 

26 

display a menu 

27 

add menu item 

28 


29 


30 


31 


from tkinter import * 

class MenuDemo: 

def _i ni t_(sel f) : 

window = Tk() 

window. titleC'Menu Demo") 

# Create a menu bar 
menubar = Menu(window) 

window.configCmenu = menubar) # Display the menu bar 

# Create a pull-down menu, and add it to the menu bar 
operationMenu = Menu(menubar, tearoff = 0) 

menubar.add_cascade(label = Operation", menu = operationMenu) 
operationMenu.add_command(label = "Add" , 
command = self.add) 

operationMenu.add_command(label = "Subtract", 
command = self.subtract) 
operationMenu.add_separator() 
operationMenu.add_command(label = "Multiply", 
command = self.multiply) 
operationMenu.add_command(label = "Divide", 
command = self.divide) 

# Create more pull-down menus 
exitmenu = Menu(menubar, tearoff = 0) 

menubar.add_cascade(label = "Exit", menu = exitmenu) 
exitmenu.add_command(label = "Quit", command = window.quit) 

# Add a tool bar frame 

frameO = Frame(window) # Create and add a frame to window 
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frameO.grid(row = 1, column = 1, sticky = W) 


# Create images 

plusimage = PhotoImage(fi 1 e = image/plus.gif ) 
minusimage = PhotoImage(fi1e = 'image/minus.gif") 
timesimage = PhotoImage(fi1e = "image/times.gif") 
dividelmage = PhotoImage(fi1e = "image/divide.gif") 

create an image 

Button(frameO, image = plusimage, command = 

self.add).grid(row = 1, column = 1, sticky = W) 

Button(frameO, image = minusimage, 

command = self.subtract).grid(row = 1, column = 2) 
Button(frameO, image = timesimage, 

command = self.multiply).grid(row = 1, column = 3) 
Button(frameO, image = dividelmage, 

command = self.divide).grid(row = 1, column = 4) 

create a button 

# Add labels and entries to framel 
framel = Frame(window) 

framel.grid(row = 2, column = 1, pady = 10) 

Label(framel, text = "Number 1: ") .pack(side = LEFT) 
self.vl = StringVarO 

Entry(framel, width = 5, textvariable = self.vl, 
justify = RIGHT).pack(side = LEFT) 

Label(framel, text = "Number 2:' ).pack(side = LEFT) 
self.v2 = StringVarO 

Entry(framel, width = 5, textvariable = self.v2, 
justify = RIGHT).pack(side = LEFT) 

Label(framel, text = "Result: ") .pack(side = LEFT) 
self.v3 = StringVarO 

Entry(framel, width = 5, textvariable = self.v3, 
justify = RIGHT).pack(side = LEFT) 


# Add buttons to frame2 

frame2 = Frame(window) # Create and add a frame to window 
frame2.grid(row = 3, column = 1, pady = 10, sticky = E) 
Button(frame2, text = 'Add' , command = self.add).pack( 
side = LEFT) 

Button(frame2, text = "Subtract", 

command = self.subtract).pack(side = LEFT) 

Button(frame2, text = "Multiply", 

command = self.multiply).pack(side = LEFT) 

Button(frame2, text = "Divide' , 

command = self.divide).pack(side = LEFT) 



mai nloopO 


def add(self): 

self .v3.set(eval (self .vl.getO) + eval (self.v2 .get())) 

callback method 

def subtract(self): 

self .v3.set(eval (self .vl.getO) - eval (self.v2 .get())) 

callback method 

def multiply(self): 

self .v3.set(eval (self .vl.getO) * eval (self.v2 .get())) 

callback method 

def di vi de(sel f) : 

self .v3.set(eval (self .vl.getO) / eval (self.v2 .get())) 

callback method 


MenuDemoO # Create GUI 


create GUI 


292 Chapter 9 GUI Programming Using Tkinter 
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Multiply 5 Number2:| 3 Result:] 8 
Divide | 

Add Subtract Multiply Divide 


(a) 



(b) 


Add 

Subtract 

Multiply 

Divide I 


(c) 


Figure 9.14 The program performs arithmetic operations using menu commands, toolbar buttons, and buttons. 


The program creates a menu bar in line 9, and the menu bar is added to the window. To dis¬ 
play the menu, use the config method to add the menu bar to the container (line 10). To cre¬ 
ate a menu inside a menu bar, use the menu bar as the parent container (line 13) and invoke 
the menu bar’s add_cascade method to set the menu label (line 14). You can then use the 
add_command method to add items to the menu (lines 15-23). Note that the tearoff is set 
to 0, which specifies that the menu cannot be moved out of the window. If this option is not 
set, the menu can be moved out of the window, as shown in Figure 9.14c. 

The program creates another menu named Exit (lines 26-27) and adds the Quit menu 
item to it (line 28). 

The program creates a frame named f rameO (lines 31-32) and uses it to hold toolbar but¬ 
tons. The toolbar buttons are buttons with images, which are created by using the 
Photoimage class (lines 35-38). The command for each button specifies a callback function 
to be invoked when a toolbar button is clicked (lines 40-47). 

The program creates a frame named framel (lines 50-51) and uses it to hold labels and 
entries for numbers. Variables vl, v2, and v3 bind the entries (lines 53, 57, and 61). 

The program creates a frame named f rameZ (lines 66-67) and uses it to hold four buttons 
for performing Add, Subtract, Multiply, and Divide. The Add button. Add menu item, and 
Add tool bar button have the same callback function add (lines 79-80), which is invoked 
when any one of them—the button, menu item, or tool bar button—is clicked. 


V 5 Point 


9.10 Popup Menus 

A popup menu, also known as a context menu, is like a regular menu, but it does not 
have a menu bar and it can float anywhere on the screen. 


Creating a popup menu is similar to creating a regular menu. First, you create an instance of 
Menu, and then you can add items to it. Finally, you bind a widget with an event to pop up 
the menu. 

The example in Listing 9.14 uses popup menu commands to select a shape to be displayed 
in a canvas, as shown in Figure 9.15. 


Listing 9.14 PopupMenuDemo.py 

1 from tkinter import * # Import all definitions from tkinter 

2 

3 class PopupMenuDemo: 

4 def _init_(self): 

5 window = Tk() # Create a window 

6 window. titleC'Popup Menu Demo") # Set title 

7 
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8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 
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26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 


# Create a popup menu 
self.menu = Menu(window, tearoff = 0) 
self.menu.add_command(label = "Draw a line", 
command = self.displayLine) 
self.menu.add_command(label = "Draw an oval", 
command = self.displayOval) 
self.menu.add_command(label = 'Draw a rectangle", 
command = self.displayRect) 
self.menu.add_command(label = "Clear", 
command = self.clearCanvas) 


# Place canvas in window 

self.canvas = Canvas(window, width = 200, 
height = 100, bg = 'white") 
self.canvas.pack() 

# Bind popup to canvas 

self.canvas.bi nd("<Button-3>" , self.popup) 
window.mainloopO # Create an event loop 


# Display a rectangle 
def displayRect(self): 

self.canvas. create_rectangle(10, 10, 190, 90, tags = "rect") 


# Display an oval 

def displayOval(self): 

self.canvas.create_oval (10, 10, 190, 90, tags = "oval") 

# Display two lines 
def displayLine(self): 

self.canvas. create_line(10, 10, 190, 90, tags = "line") 
self.canvas. create_line(10, 90, 190, 10, tags = "line") 


# Clear drawings 
def clearCanvas(self): 

self.canvas. deleteC'rect", "oval", "line") 


def popup(self, event): 

self.menu.post(event.x_root, event.y_root) 

PopupMenuDemoO # Create GUI 


create a menu 
add menu item 


create a canvas 


bind popup menu 


display rectangle 


display oval 


display lines 


clear canvas 


create GUI 




(a) (b) (c) 

Figure 9.15 The program displays a popup menu when the canvas is clicked. 


The program creates a menu to hold menu items (lines 9-17). A canvas is created to 
display the shapes. The menu items use callback functions to instruct the canvas to draw 
shapes. 
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Customarily, you display a popup menu by pointing to a widget and clicking the right 
mouse button. The program binds the right mouse button click with the popup callback 
function on the canvas (line 25). When you click the right mouse button, the popup call¬ 
back function is invoked, which displays the menu at the location where the mouse is 



clicked. 
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What method do you use to display a menu bar? 

How do you display a popup menu? 

c/Key 

9.1 1 

You can 

Mouse, Key Events, and Bindings 

use the bi nd method to bind mouse and key events to a widget. 


Point preceding example used the widget’s bi nd method to hind a mouse event with a callback 

handler by using the syntax; 

widget.bind(event, handier) 

If a matching event occurs, the handler is invoked. In the preceding example, the event is 
<Button-3> and the handler function is popup. The event is a standard Tkinter object, 
which is automatically created when an event occurs. Every handler has an event as its argu¬ 
ment. The following example defines the handler using the event as the argument; 

def popup(event): 

menu.post(event.x_root, event.y_root) 

The event object has a number of properties describing the event pertaining to the event. 
For example, for a mouse event, the event object uses the x, y properties to capture the cur¬ 
rent mouse location in pixels. 

Table 9.2 lists some commonly used events and Table 9.3 lists some event properties. 

The program in Listing 9.15 processes mouse and key events. It displays the window as 
shown in Figure 9.16a. The mouse and key events are processed and the processing informa¬ 
tion is displayed in the command window, as shown in Figure 9.16b. 


Table 9.2 Events 

Event 

<B7-Motion> 

<Button-7> 


<ButtonReIeased- i> 
<Doub1e-Button- i> 
<Enter> 

<Key> 

<Leave> 

<Return> 

<Shift+A> 

<Tr7 pi e-Button- i> 


Description 

An event occurs when a mouse button is moved while being held down on the widget. 

Button-1, Button-2, and Button-3 identify the left, middle, and right buttons. When a mouse button 
is pressed over the widget, Tkinter automatically grabs the mouse pointer’s location. ButtonPressed-i is 
synonymous with Button-i. 

An event occurs when a mouse button is released. 

An event occurs when a mouse button is double-clicked. 

An event occurs when a mouse pointer enters the widget. 

An event occurs when a key is pressed. 

An event occurs when a mouse pointer leaves the widget. 

An event occurs when the Enter key is pressed. You can bind any key such as A, B, Up, Down, Left, Right 
in the keyboard with an event. 

An event occurs when the Shift+A keys are pressed. You can combine Alt, Shift, and Control with other keys. 
An event occurs when a mouse button is triple-clicked. 
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Table 9.3 Event Properties 

Event Property 

Description 

char 

keycode 

keysym 

num 

widget 

X and y 

X_root and y_root 

The character entered from the keyboard for key events. 

The key code (i.e., Unicode) for the key entered from the keyboard for key events. 

The key symbol (i.e., character) for the key entered from the keyboard for key events. 

The button number (1, 2, 3) indicates which mouse button was clicked. 

The widget object that fires this event. 

The current mouse location in the widget in pixels. 

The current mouse position relative to the upper-left corner of the screen, in pixels. 


Listing 9.15 MouseKeyEventDemo. py 

1 from tkinter import * # Import all definitions from tkinter 

2 

3 class MouseKeyEventDemo: 

4 def _init_(self): 

5 window = Tk() # Create a window 

6 window.title ("Event Demo") # Set a title 

7 canvas = Canvas(window, bg = 'white", width = 200, height = 100) 

8 canvas. packO 

9 

10 # Bind with <Button-l> event 

11 canvas.bi nd('<Button-l>" , self.processMouseEvent) 

12 

13 # Bind with <Key> event 

14 canvas.bi nd("<Key>" , self.processKeyEvent) 

15 canvas.focus_set() 

16 

17 window.mainloopO # Create an event loop 

18 

19 def processMouseEvent(self, event): 

20 pri ntC'cl icked at", event.x, event.y) 

21 pri ntC'Position in the screen", event.x_root, event.y_root) 

22 print('Which button is clicked? ", event.num) 

23 

24 def processKeyEvent(self, event): 

25 pri ntC'keysym? , event.keysym) 

26 printC'char? ' , event.char) 

27 pri ntC'keycode? , event.keycode) 

28 

29 MouseKeyEventDemoO # Create GUI 


create a canvas 


bind a mouse event 


bind a key event 
set focus 


process mouse event 


process key event 


create GUI 



I Administrator Command Prompt 


^^^^^^^MouseK^EventDemo.py 




\pybook>pvthon MouseKepEventDeno.pp 
clicked at 138 72 
Position in the screen 376 330 
l^hich button is clicked? 1 
clicked at 107 78 
Position in the screen 345 336 
Uhich button is clicked? 1 
ikepsym? g 
"jchar? g 

■ 71 

Return 

13 



(a) 

Figure 9.16 The program processes mouse and key events. 


(b) 
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The program creates a canvas (line 7) and binds a mouse event <Button-l> with the call¬ 
back function processMouseEvent (line 11) on the canvas. Nothing is drawn on the canvas. 
So it is blank as shown in Figure 9.16a. When the left mouse button is clicked on the canvas, 
an event is created. The processMouseEvent is invoked to process an event that displays 
the mouse pointer’s location on the canvas (line 20), on the screen (line 21), and which mouse 
button is clicked (line 22). 

The Canvas widget is also the source for the key event. The program binds a key event 
with the callback function processKeyEvent on the canvas (line 14) and sets the focus on 
the canvas so that the canvas will receive input from the keyboard (line 15). 

Listing 9.16 displays a circle on the canvas. The circle radius is increased with a left mouse 
click and decreased with a right mouse click, as shown in Figure 9.17. 


initialize GUI 
set radius property 


create canvas 


bind a mouse event 
bind a mouse event 


increase circle 


decrease circle 


create GUI 


Listing 9.16 EnlargeShrinkCi rcle.py 

from tkinter import * # Import all definitions from tkinter 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 
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22 

23 

24 

25 
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28 

29 

30 

31 

32 

33 
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35 
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38 


class EnlargeShrinkCircle: 

def _i ni t_(sel f) : 

self.radius = 50 

window = Tk() # Create a window 

window. titleC'Control Circle Demo") # Set a title 
self.canvas = Canvas(window, bg = "white", 
width = 200, height = 200) 
self.canvas.pack() 
self.canvas.create_oval( 

100 - self.radius, 100 - self.radius, 

100 + self.radius, 100 + self.radius, tags = "oval") 


# Bind canvas with mouse events 
self.canvas.bind( '<Button-l>' , 
self.canvas.bind( ’<Button-3>' , 


self.increaseCircle) 
self.decreaseCircle) 


self.radius, 
self.radius, 


window.mainloopO # Create an event loop 


def increaseCircle(self, event): 
self.canvas.del ete("oval ") 
if self.radius < 100: 

self.radius += 2 
self.canvas.create_oval( 

100 - self.radius, 100 - 

100 + self.radius, 100 + 

def decreaseCircle(self, event): 
self.canvas.del ete("oval ") 
if self.radius > 2: 

self.radius -= 2 
self.canvas.create_oval( 

100 - self.radius, 100 - 

100 + self.radius, 100 + 

EnlargeShrinkCircle() # Create GUI 


tags = "oval") 


self.radius, 
self.radius, 


tags = "oval") 


The program creates a canvas (line 9) and displays a circle on the canvas with an initial 
radius of 50 (lines 5 and 12-14). The canvas is bound to a mouse event <Button-l> with the 
handler increaseCi rcle (line 17) and to a mouse event <Button-3> with the handler 
decreaseCi rcle (line 18). When the left mouse button is pressed, the increaseCi rcle 
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Figure 9.17 The program uses mouse events to control the circle’s size. 


function is invoked to increase the radius (lines 24-25) and redisplay the circle (lines 26-28). 
When the right mouse button is pressed, the decreaseCi rcl e function is invoked to 
decrease the radius (lines 32-33) and redisplay the circle (lines 34-36). 

9.30 How do you bind a canvas with the left mouse click event and callback function p? 
9.3 I What is the event for moving the mouse while pressing the right mouse button? 

9.32 What is the event for clicking the left mouse button twice? 

9.33 What is the event for clicking the middle mouse button three times? 

9.34 What argument is automatically passed to an event-handling function? 

9.35 How do you get the current mouse location from the event object? 

9.36 How do you get the key character from the event object? 

9.12 Animations 

Animations can be created by displaying a sequence of drawings. 

The Canvas class can be used to develop animations. You can display graphics and text on 
the canvas and use the move (tags, dx, dy) method to move the graphic with the specified 
tags dx pixels to the right if dx is positive and dy pixels down if dy is positive. If dx or dy is 
negative, the graphic is moved left or up. 

The program in Listing 9.17 displays a moving message repeatedly from left to right, as 
shown in Figure 9.18. 

Listing 9.17 AnimationDemo.py 

1 from tkinter import * # Import all definitions from tkinter 

2 

3 class AnimationDemo: 

4 def _init_(self): 

5 window = Tk() # Create a window 

6 window.titl eC'Animation Demo") # Set a title 

7 


8 

width = 250 # Width of the canvas 

9 

canvas = Canvas(window, bg = 

'white". 

10 

width = 250, height = 50) 


11 

canvas.pack() 


12 



13 

X = 0 # Starting x position 


14 

canvas.create_text(x, 30, 


15 

text = 'Message moving?". 

tags = 'text") 
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16 



17 

dx = 3 


18 

while True: 

move text 

19 

canvas .moveC'text" , dx, 0) # Move text dx unit 

sleep 

20 

canvas.after (100) # Sleep for 100 milliseconds 

update canvas 

21 

canvas.updateO # Update canvas 


22 

if x < width: 


23 

x += dx # Get the current position for string 


24 

el se: 

restart from left 

25 

x = 0 # Reset string position to the beginning 

delete text 

26 

canvas.del ete("text") 


27 

# Redraw text at the beginning 

create a text string 

28 

canvas.create_text(x, 30, text = "Message moving? 


29 

tags = "text") 


30 



31 

window.mainloopO # Create an event loop 


32 


create GUI 

33 

Ani mati onDemoO # Create GUI 


*7ii^ Animation 


Animation 

1 Message moving? 



Figure 9.18 The program animates a moving message. 


The program creates a canvas (line 9) and displays text on the canvas at the specified initial 
location (lines 13-15). The animation is done essentially in the following three statements in 
a loop (lines 19-21): 

canvas. moveC'text" , dx, 0) # Move text dx unit 
canvas.after (100) # Sleep for 100 milliseconds 
canvas.updateO # Update canvas 

The x-coordinate of the location is moved to the right dx units by invoking canvas. move 
(line 19). Invoking canvas. after (100) puts the program to sleep for 100 milliseconds 
(line 20). Invoking canvas. updateO redisplays the canvas (line 21). 

You can add tools to control the animation’s speed, stop the animation, and resume the ani¬ 
mation. Listing 9.18 rewrites Listing 9.17 by adding four buttons to control the animation, as 
shown in Figure 9.19. 

Listing 9.18 Cont rol Ani mati on. py 

1 from tkinter import * # Import all definitions from tkinter 

2 

3 class ControlAnimation: 

4 def _init_(self): 

5 window = Tk() # Create a window 

6 window.title ("Control Animation Demo") # Set a title 

7 

8 self.width = 250 # Width of self.canvas 

9 self.canvas = Canvas(window, bg = "white"_ 

10 width = self.width, height = 50) 

11 self .canvas.packO 

12 

13 frame = Frame(window) 

14 frame. packO 

15 btStop = Button(frame, text = "Stop", command = self.stop) 
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16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 

60 
61 
62 

63 

64 

65 

66 


btStop.pack(side = LEFT) 
btResume = Button(frame, text = "Resume", 
command = self.resume) 
btResume.pack(side = LEFT) 
btFaster = Button(frame, text = "Faster", 
command = self.faster) 
btFaster.pack(side = LEFT) 
btSlower = Button(frame, text = "Slower", 
command = self.slower) 
btSl ower. pack(s'i de = LEFT) 

self.x = 0 # Starting x position 
self.sleepTime = 100 # Set a sleep time 
self.canvas.create_text(self.x, 30 , 

text = "Message moving?", tags = "text") 

self.dx = 3 

self.isStopped = False 
self .animateO 

window.mainloopO # Create an event loop 

def stop(self): # Stop animation 
self.isStopped = True 

def resume(self): # Resume animation 
self.isStopped = False 
self .animateO 

def faster(self): # Speed up the animation 
if self.sleepTime > 5: 
self.sleepTime -= 20 

def slower(self): # Slow down the animation 
self.sleepTime += 20 

def animate(self): # Move the message 
while not self.isStopped: 

sel f. canvas .moveC'text'' , self.dx, 0) # Move text 
self.canvas.after(self.sleepTime) # Sleep 
self.canvas.updateO # Update canvas 
if self.x < self.width: 

self.x += self.dx # Set new position 
else: 

self.x = # Reset string position to beginning 

self.canvas.del ete("text") 

# Redraw text at the beginning 
self.canvas.create_text(self.x, 30 , 

text = "Message moving?", tags = "text") 

ControlAnimationO # Create GUI 


starting position 
initial sleep time 


stop 


resume 


faster 


slower 


animate 


update 


create GUI 



Control Animation Demo 

Message moving? 

Stop j Resume 

Faster 

Slower 

1 


Figure 9.19 The program uses buttons to control the animation. 
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The program starts the animation by invoking animateC) (line 34). The isStopped 
variable determines whether the animation continues to move. It is set to Fal se initially 
(line 33). When it is false, the loop in the animate method executes continuously (lines 
53-64). 

Clicking the buttons Stop, Resume, Faster, or Slower stops, resumes, speeds up, or slows 
down the animation. When the Stop button is clicked, the stop function is invoked to set 
isStopped to True (line 39). This causes the animation loop to terminate (line 53). When 
the Resume button is clicked, the resume function is invoked to set isStopped to False 
(line 42) and resume animation (line 43). 

The speed of the animation is controlled by the variable si eepTi me, which is set to 100 
milliseconds initially (line 28). When the Faster button is clicked, the faster method is 
invoked to reduce sleepTime by 20 (line 47). When the Slower button is clicked, the 
slower function is invoked to increase sleepTime by 20 (line 50). 


/Check 
V Point 

MyProgrammingLab" 


9.37 What method can you use to put the program to sleep? 

9.38 What method can you use to update the drawing? 


9.13 Scrollbars 




A Scrol 1 bar widget can be used to scroll the contents in a Text, Canvas, or 
Li stbox widget vertically or horizontally. 


Listing 9.19 gives an example of scrolling in a Text widget, as shown in Figure 9.20. 


create a Scrol 1 bar 
create Text 


tie scrollbar with text 


create GUI 


Listing 9.19 Scroll Text, py 

1 from tkinter import * # Import all definitions from tkinter 

2 

3 class ScrollText: 

4 def _init_(self): 

5 window = Tk() # Create a window 

6 window. titleC'Scroll Text Demo") # Set title 

7 

8 framel = Frame(window) 

9 framel. packO 

10 scrollbar = Scrol1bar(framel) 

11 scrol1 bar.pack(side = RIGHT, fill = Y) 

12 text = Text(framel, width = 40, height = 10, wrap = WORD, 

13 yscrol1 command = scrol1 bar.set) 

14 text.packO 

15 sc roll bar.config(command = text.yview) 

16 

17 window.mainloopO # Create an event loop 

18 

19 ScrolITextO # Create GUI 


Scroll TpYt npmo 1"— njdskirttiShij 


Four score and seven years ago our 
fathers brought forth on this — 

continent, a new nation, 
conceived in Liberty, and dedicated to 
the proposition that all men are 
created equal. 

1 


Figure 9.20 You can use the scrollbar (on the far right) to scroll to see text not currently 
visible in the Text widget. 
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The program creates a Scrol 1 bar (line 10) and places it to the right of the text (line 11). 
The scrollbar is tied to the Text widget (line 15) so that the contents in the Text widget can 
be scrolled through. 


9.39 What widgets can be used with a scrollbar? 

9.40 How do you associate a scrollbar with a view? 


W P( 


heck 

Point 
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9.14 Standard Dialog Boxes 

You can use standard dialog boxes to display message boxes or to prompt the user to 
enter numbers and strings. 


^/Key 
"P / Point 


Finally, let’s look at Tkinter’s standard dialog boxes (often referred to simply as dialogs). 
Listing 9.20 gives an example of using these dialogs. A sample run of the program is shown 
in Figure 9.21. 


Listing 9.20 Di al ogDemo. py 

1 import tkinter.messagebox 

2 import tkinter.simpiedialog 

3 import tkinter.colorchooser 

4 

5 tkinter.messagebox.showinfoC 'showinfo", "This is an info msg' ) showinfo 

6 

7 tkinter.messagebox.showwarni ngC'showwarning" , "This is a warning") showwarning 

8 

9 tkinter.messagebox. showerrorC'showerror" , "This is an error") showerror 

10 

11 isYes = tkinter.messagebox. askyesnoC'askyesno" , "Continue?") askyesno 

12 print(isYes) 

13 

14 isOK = tkinter.messagebox.askokcancel ("askokcancel", "OK?") askokcancel 

15 print(isOK) 

16 

17 isYesNoCancei = tkinter.messagebox.askyesnocancei( askyesnocancel 

18 "askyesnocancel", "Yes, No, Cancel?") 

19 print(isYesNoCancel) 

20 

21 name = tkinter.simpledialog.askstringC 

22 "askstring", "Enter your name") 

23 print(name) 

24 

25 age = tkinter.simpledialog.askinteger( 

26 "askinteger" , "Enter your age") 

27 print(age) 

28 

29 weight = tkinter.simpledialog.askfloat( 

30 "askfloat", "Enter your weight") 

31 print(weight) 


askstri ng 


aski nteger 


askfloat 


The program invokes the showinfo, showwarning, and showerror functions to display 
an information message (line 5), a warning (line 7), and an error (line 9). These functions are 
defined in the tki nter. messagebox module (line 1). 

The askyesno function displays the Yes and No buttons in the dialog box (line 11). The 
function returns True if the Yes button is clicked or Fal se if the No button is clicked. 
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askokcancel 


! 

OK? 

dk i 

Cancel | | 






7^ askinteger 

1 

^ Enter your name 

Enter your age 

SmithI 


1€| 

OK Cancel | 

OK Cancel 1 . 



Figure 9.21 You can use the standard dialogs to display message boxes and accept input. 


The askokcancel function displays the OK and Cancel buttons in the dialog box (line 
14). The function returns True if the OK button is clicked or Fal se if the Cancel button is 
clicked. 

The askyesnocancel function displays the Yes, No, and Cancel buttons in the dialog box 
(line 17). The function returns True if the Yes button is clicked, Fal se if the No button is 
clicked or None if the Cancel button is clicked. 

The askstr i ng function (line 21) returns the string entered from the dialog box after the 
OK button is clicked or None if the Cancel button is clicked. 

The askinteger function (line 25) returns the integer entered from the dialog box after 
the OK button is clicked or None if the Cancel button is clicked. 

The askfl oat function (line 29) returns the float entered from the dialog box after the OK 
button is clicked or None if the Cancel button is clicked. 

modal All the dialog boxes are modal windows, which means that the program cannot continue 

until a dialog box is dismissed. 


iCheck 
W Point 

MyProgrammingLab" 


9.41 Write a statement that displays “Welcome to Python” in a message dialog. 

9.42 Write statements using a dialog box to prompt the user to enter an integer, a float, and 
a string. 


Key Terms 


callback functions 274 
geometry manager 278 
grid manager 282 
handlers 274 


pack manager 284 
parent container 273 
place manager 286 
widget class 273 
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Chapter Summary 

1 . To develop a GUI application in Tkinter, first use the Tk class to create a window, 
then create widgets and place them inside the window. The first argument of each 
widget class must be the parent container. 

2 . To place a widget in a container, you have to specify its geometry manager. 

3. Tkinter supports three geometry managers: pack, grid, and place. The pack manager 
places widgets side by side or on top of each other. The grid manager places widgets 
in grids. The place manager places the widget in absolute locations. 

4. Many widgets have the command option for binding an event with a callback func¬ 
tion. When an event occurs, the callback function is invoked. 

5 . The Canvas widget can be used to draw lines, rectangles, ovals, arcs, and polygons, 
and to display images and text strings. 

6 . Images can be used in many widgets such as labels, buttons, check buttons, radio but¬ 
tons, and canvases. 

7. You can use the Menu class to create menu bars, menu items, and popup menus. 

8 . You can bind mouse and key events to a widget with a callback function. 

9. You can use canvases to develop animations. 

10. You can use standard dialog boxes to display messages and receive input. 


Test Questions 

Do test questions for this chapter online at www.es.armsU'ong.edu/liang/py/test.html. 


Programming Exercises 
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Note 

The image icons used in the exercises throughout the book can be obtained from 
www.cs.armstrong.edu/liang/py/book.zip under the image folder. 


download image files 


Sections 9.2-9.8 

*9.1 {Move the ball) Write a program that moves a ball in a panel. You should define a 
panel class for displaying the ball and provide the methods for moving the ball 
left, right, up, and down, as shown in Figure 9.22a. Check the boundaries to pre¬ 
vent the ball from moving out of sight completely. 

*9.2 (Create an investment-value calculator) Write a program that calculates the future 
value of an investment at a given interest rate for a specified number of years. The 
formula for the calculation is as follows: 

futurevalue = investmentAmount * (1 + monthlylnterestRate)^^''^ ^ 
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Investment Calculator 


' Investment Amount 

10000 

Years 

3 

Annual Interest Rate 

3.2^1 

1 Future Value 

11022.66 

1 

Calcutste 0 


(a) (b) 


Figure 9.22 (a) You can click a button to move the ball, (b) You can obtain the future value 

by entering the investment amount, years, and annual interest rate. 


Use text fields for users to enter the investment amount, years, and interest rate. 
Display the future amount in a text field when the user clicks the Calculate button, 
as shown in Figure 9.22b. 

*9.3 {Select geometric figures) Write a program that draws a rectangle or an oval, as 
shown in Figure 9.23. The user selects a figure from a radio button and specifies 
whether it is filled by selecting a check button. 


Radiobuttons and Checkbuttons 





Rectangle ^ Oval f Filled 




Figure 9.23 The program displays a rectangle or an oval when you select a shape type, and 
whether it is filled. 


*9.4 {Display rectangles) Write a program that displays 20 rectangles, as shown in 
Figure 9.24. 



Figure 9.24 The program displays 20 rectangles. 


9.5 {Game: display a checkerboard) Write a program that displays a checkerboard in 
which each white and black cell is a canvas with a background of black or white, 
as shown in Figure 9.25a. 























































































































Programming Exercises 305 



oool 

OXOl 


(b) 


















1 











(c) 



(d) 


Figure 9.25 (a) The programs display a checkerboard, (b) a tic-tac-toe board, (c) a grid, and (d) numbers in a triangular 

formation. 


9.6 (Game: display a tic-tac-toe board) Write a program that displays nine labels. 
Each label may display an image icon for an X or an image icon for an O, as 
shown in Figure 9.25b. What to display is randomly decided. Use the 
random. randIntCO, 1) function to generate an integer 0 or 1, which corre¬ 
sponds to displaying a cross image (X) icon or a not image (O) icon. The cross and 
not images are in the files x. gi f and o. gi f . 

9.7 (Display and: X 8 ) Write a program that displays an 8 X 8 grid, as shown in 

Figure 9.25c. Use red for vertical lines and blue for horizontal lines. 

**9.8 (Display numbers in a triangular pattern) Write a program that displays numbers 
in a triangular pattern, as shown in Figure 9.25d. The number of lines in the dis¬ 
play changes to fit the window as the window resizes. 

**9.9 (Display a bar chart) Write a program that uses a bar chart to display the percent¬ 
ages of the overall grade represented by the project, quizzes, the midterm exam, 
and the final exam, as shown in Figure 9.26a. Suppose that the project is 20 per¬ 
cent of the grade and its value is displayed in red, quizzes are 10 percent and are 
displayed in blue, the midterm exam is 30 percent and is displayed in green, and 
the final exam is 40 percent and is displayed in orange. 



Figure 9.26 (a) The programs display a bar chart and (b) a pie chart. 
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**9.10 (Display a pie chart) Write a program that uses a pie chart to display the percent¬ 
ages of the overall grade represented hy the project, quizzes, the midterm exam, 
and the final exam, as shown in Figure 9.26b. Suppose that project is weighted as 
20 percent of the grade and is displayed in red, quizzes are 10 percent and are dis¬ 
played in blue, the midterm exam is 30 percent and is displayed in green, and the 
final exam is 40 percent and is displayed in orange. 

**9.l I (Display a clock) Write a program that displays a clock to show the current time, 
as shown in Figure 9.27a. To obtain the current time, use the datetime class in 
Supplement II.B. 




(b) (c) 


Figure 9.27 (a) The program displays a clock for the current time, (b-c) The program 

alternates between the display of two messages. 


Sections 9.9-9.14 

**9.I2 (Alternate two messages) Write a program to change, with a left mouse click, 
between two messages displayed on a canvas, “Programming is fun” and “It is fun 
to program,” as shown in Figure 9.27b-c. 

*9.13 (Display the mouse position) Write two programs: one that displays the mouse 
position when the mouse is clicked (see Figure 9.28a-b), and the other displays 
the mouse position when the mouse button is pressed and ceases to display it when 
the mouse button is released. 

*9.14 (Draw lines using the arrow keys) Write a program that draws line segments using 
the arrow keys. The line starts from the center of the frame and draws toward east, 
north, west, or south when the Right arrow key. Up arrow key. Left arrow key, or 
Down arrow key is clicked, as shown in Figure 9.28c. 



Arrow Keys 



P 

1 



Figure 9.28 (a-b) The program displays the location of the mouse pointer when the mouse is clicked, (c) The program 

draws a line when the Up, Down, Left, and Right arrow keys are pressed. 
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**9.I5 {Display a still fan) Write a program that displays a still fan, as shown in 
Figure 9.29a. 

**9.16 {Display a running fan) Write a program that displays a fan running, as shown in 
Figure 9.29a. 

**9.I7 {Racing car) Write a program that simulates car racing, as shown in Figure 
9.29b-d. The car moves from left to right. When it reaches the right end, it restarts 
from the left and continues the same process. Let the user increase and decrease 
the car’s speed by pressing the Up and Down arrow keys. 



y-30 

y-20- 

y-10- 

y- 


x+20 x+40 

I I I I I 


■n 


B 


■ 



B 


(x.y) 

(d) 


Figure 9.29 (a) The programs display a fan and (b-c) a moving car. (d) You can redraw a car with a new base point. 


*9.18 {Display flashing text) Write a program that displays the flashing text “Welcome,” 

as shown in Figure 9.30a-b. (Flint: To make the text flash, you need to repeatedly 
draw it on the canvas or alternately delete it. Use a Boolean variable to control the 
alternation.) 

*9.19 {Move a circle using keys) Write a program that moves a circle up, down, left, or 
right using the arrow keys, as shown in Figure 9.30c-d. 


Flashing 


Flashing Te«t 


7i Movina Circle 


TirrU* 

Welcome 

1 




O 


o 

(a) 

(b) 


(c) 


(d) 


Figure 9.30 (a-b) The program displays a flashing label with text, (c-d) The circle is moved when the arrow keys are 

pressed. 


**9.20 {Geometry: inside a circle?) Write a program that draws a fixed circle centered at 
(100, 60) with radius 50. Whenever the mouse is moved while the left button is 
pressed, display the message indicating whether the mouse pointer is inside the 
circle, as shown in Figure 9.31. 

**9.2 I {Geometry: inside a rectangle?) Write a program that draws a fixed rectangle cen¬ 
tered at (100, 60) with width 100 and height 40. Whenever the mouse is moved, 
display the message indicating whether the mouse pointer is inside the rectangle, 
as shown in Figure 9.32. To detect whether the pointer is inside a rectangle, use the 
Rectangl e2D class defined in Exercise 8.19. 
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Figure 9.31 Detect whether the mouse pointer is inside a circle. 


Inside the rectangle? 


Muu:>c puiiilci itul in Ihe iccldiigle 










1 Inside the rectangle? 


1 



the rectangle 

1 


Figure 9.32 Detect whether the mouse pointer is inside a rectangle. 


**9.22 (Geometry: pendulum) Write a program that animates a pendulum swinging, as 
shown in Figure 9.33. Press the Up arrow key to increase the speed and the Down 
arrow key to decrease it. Press the S key to stop the animation and the R key to 
resume it. 



Figure 9.33 The program animates a pendulum swinging. 


*9.23 (Buttons and radio buttons) Write a program that uses radio buttons to select back¬ 
ground colors for text, as shown in Figure 9.34. The available colors are red, yel¬ 
low, white, gray, and green. The program uses the buttons <= and = > to move 
the text left or right. 


Radio buttons and buttons 




C Red C Yellow ^ White Gray C" Green 


Welcome 



Figure 9.34 The <= and => buttons move the message on the panel, and you can also set 
the background color for the message. 
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9.24 {Display circles) Write a program that displays a new larger circle with a left 
mouse click and removes the largest circle with a right mouse click, as shown in 
Figure 9.35. 




Figure 9.35 The program adds/removes circles with left/right mouse clicks. 

** 9.25 {Traffic lights) Write a program that simulates a traffic light. The program lets the 
user select one of three lights: red, yellow, or green. When a radio button is 
selected, the light is turned on, and only one light can be on at a time (see 
Figure 9.36a-b). No light is on when the program starts. 

* 9.26 {Display balls with random colors) Write a program that displays ten balls with 
random colors and placed at random locations, at shown in Figure 9.36c. 


74 Random Balls! 


O 

o 

• 

o 


• 0 

• • 

o 


o 


Display j 


74 Traffic Lights 

Red r 

• 

0 

0 

Yellow 

Green 


74 Traffic Ughts 

C Red r 

0 

o 

• 

Yellow 

Green 


(a) (b) (c) 

Figure 9.36 (a-b) The radio buttons let the user choose a traffic light color, (c) Ten balls with random colors are 

displayed at random locations. 


* 9.27 {Compare loans with various interest rates) Rewrite Exercise 5.23 to create the 
user interface shown in Figure 9.37. Your program should let the user enter the 
loan amount and loan period in the number of years from a text field, and should 
display the monthly and total payments for each interest rate starting from 5 per¬ 
cent to 8 percent, with increments of one-eighth, in a text area. 

** 9.28 {Geometry: display angles) Write a program that enables the user to drag the ver¬ 
tices of a triangle and displays the angles dynamically, as shown in Figure 9.38a. 
Change the mouse cursor to the cross-hair shape when the mouse is moved close 
to a vertex. The formula to compute angles A, B, and C (see Figure 9.38b) is given 
in Listing 3.2. 

Hint: Use the Point class to represent a point, as described in Exercise 8.17. Cre¬ 
ate three points at random locations initially. When the mouse is moved close to a 
point, change the cursor to a cross-hair pointer (-I-) and reset the point to where the 
mouse is. Whenever a point is moved, redisplay the triangle and the angles. 
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Loan Amount 

Interest Rate 
5.00 
5.12 
5.25 
5.38 
5.50 
5.62 
5.75 
5.88 
6.00 


Monthly Payitent 

188.71 

189.29 

189.86 

190.44 

191.01 

191.59 

192.17 

192.75 

193.33 


Total Payment 

11322.74 

11357.13 

11391.59 

11426.11 

11460.70 

11495.35 

11530.06 

11564.84 

11599.68 


Figure 9.37 The program displays a table for monthly payments and total payments on a 
given loan based on various interest rates. 



x2, y2 



Figure 9.38 (a-b) The program enables the user to drag vertices and display the angles dynamically, (c) The program 

enables the user to drag vertices and display the lines and their intersecting point dynamically. 


** 9.29 (Geometry: intersecting point) Write a program that displays two line segments 
with their end points and their intersecting point. Initially, the end points are at 
(20, 20) and (56, 130) for line 1 and at (100, 20) and (16, 130) for line 2. The 
user can use the mouse to drag a point and dynamically display the intersecting 
point, as shown in Figure 9.38c. (Hint: See Exercise 4.25 for finding the intersect¬ 
ing point of two unbounded lines. The hint for Exercise 9.28 applies to this exer¬ 
cise as well.) 

9.30 (Display a rectanguloid) Write a program that displays a rectanguloid, as shown 
in Figure 9.39a. 

9.31 (Display five filled circles) Write a program that displays five filled circles, as 
shown in Figure 9.39b. Enable the user to drag the blue circle using the mouse, as 
shown in Eigure 9.39c. 





(b) 



(c) 


Figure 9.39 (a) The program displays a rectanguloid. (b-c) The blue circle is dragged with the mouse. 
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* 9.32 {Two movable vertices and their distances) Write a program that displays two cir¬ 
cles with radius 20 at locations (20, 20) and (120, 50) with a line connecting the 
two circles, as shown in Figure 9.40a. The distance between the circles is dis¬ 
played along the line. The user can drag a circle. When that happens, the circle and 
its line are moved and the distance between the circles is updated. Your program 
should not allow the circles to get too close. Keep them at least 70 pixels apart 
between the two circles’ centers. 

** 9.33 {Draw an arrow line) Write a program that randomly draws an arrow line when 
the Draw a Random Arrow Line button is clicked, as shown in Figure 9.40b. 

** 9.34 {Address book) Write a program that creates a user interface for displaying an 
address, as shown in Figure 9.40c. 




(c) 


Figure 9.40 (a) The user can drag the circles and the program redisplays the distance, (b) The program draws an arrow 

line randomly, (c) The program creates a user interface for displaying addresses. 
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CHAPTER 


10 

Lists 

objectives 

■ To describe why lists are useful in programming (§10.1). 

■ To learn how to create lists (§10.2.1). 

■ To explore common operations for sequences (§ 10.2.2). 

■ To use the 1 en, mi n, max, sum, and random. shuffl e functions with a 
list (§10.2.3). 

■ To access list elements by using indexed variables (§10.2.4). 

■ To obtain a sublist from a larger list by using the slicing operator 

[start . end] (§10.2.5). 

■ To use the + (concatenation), ■' (repetition), and in/not i n operators on 
lists (§10.2.6). 

■ To traverse elements in a list using a for loop (§10.2.7). 

■ To compare the contents of two lists by using comparison operators 
(§10.2.8). 

■ To create lists by using list comprehension (§10.2.9). 

■ To invoke a list’s append, count, extend, i ndex, i nsert, pop, 
remove, reverse, and sort methods (§10.2.10). 

■ To split a string into a list using the str’s spl it method (§10.2.11). 

■ To read data from the console into a list (§ 10.2.12). 

■ To use lists in application development (§§10.3-10.5). 

■ To copy the contents of one list to another (§10.6). 

■ To develop and invoke functions that include list arguments and return 
lists (§§10.7-10.9). 

■ To search elements using the linear (§ 10.10.1) or binary (§ 10.10.2) search 
algorithm. 

■ To sort a list by using the selection sort (§10.11.1). 

■ To sort a list by using the insertion sort (§10.11.2). 

■ To develop a bouncing ball animation by using a list (§10.12). 
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why list? 


10.1 Introduction 

^Key store a collection of data of any size. 

Point Programs commonly need to store a large number of values. Suppose, for instance, that you 
need to read 100 numbers, compute their average, and then find out how many of the numbers 
are above the average. Your program first reads the numbers and computes their average, then 
compares each number with the average to determine whether it is above the average. In order 
to accomplish this task, the numbers must all be stored in variables. To do this, you would 
have to create 100 variables and repeatedly write almost identical code 100 times. Writing a 
program this way is impractical. So, how do you solve this problem? 

An efficient, organized approach is needed. Python provides a type called a list that 
stores a sequential collection of elements. In our example, you can store all 100 num¬ 
bers in a list and access them through a single list variable. The solution might look like 
Listing 10.1. 


create a list 


store number in list 


get average 


above average? 


Listing 10.1 DataAnalysis.py 

1 NUMBER_OF_ELEMENTS = 5 # For simplicity, use 5 instead of 100 

2 numbers = [] # Create an empty list 

3 sum = 0 

4 

5 for i in range(NUMBER_0F_ELEMENTS): 

6 value = eval (i nput("Enter a new number: )) 

7 numbers.appendfvalue) 

8 sum += value 

9 

10 average = sum / NUMBER_OF_ELEMENTS 

11 

12 count = 0 # The number of elements above average 

13 for i in range(NUMBER_0F_ELEMENTS): 

14 if numbers[i] > average: 

15 count += 1 

16 

17 print ("Average is", average) 

18 pri ntC'Number of elements above the average is", count) 


Enter a new number: 1 

-I Enter 


Enter a new number: 2 

Enter 


Enter a new number: 3 

Enter 


Enter a new number: 4 

*.-1 Enter 


Enter a new number: 5 

.-1 Enter 


Average is 3.0 


Number of elements above the average is 2 



The program creates an empty list (line 2). It repeatedly reads a number (line 6), appends 
it to the list (line 7), and adds it to sum (line 8). It obtains average in line 10. It then com¬ 
pares each number in the list with the average to count the number of values above the aver¬ 
age (lines 12-15). 


array 



Note 

In many other programming languages, you would use a type called an array to store a 
sequence of data. An array has a fixed size. A Python list's size is flexible. It can grow 
and shrink on demand. 
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10.2 List Basics 

A list is a sequence defined by the list class. It contains the methods for creating, 
manipulating, and processing lists. Elements in a list can be accessed through an index. 

10.2.1 Creating Lists 

The list class defines lists. To create a list, you can use 1 i st’s constructor, as follows: 
listl = listO # Create an empty list 

list2 = list([2, 3, 4]) # Create a list with elements 2, 3, 4 

lists = listCr'red", "green", "blue']) # Create a list with strings 
list4 = 1i st(rangeC3 , 6)) # Create a list with elements 3, 4, 5 

lists = listC'abcd") # Create a list with characters a, b, c, d 

You can also create a list by using the following syntax, which is a little simpler: 

listl = [] # Same as list() 

list2 = [2, 3, 4] # Same as list([2, 3, 4]) 

lists = ["red", "green'] # Same as list(["red", "green"]) 

The elements in a list are separated by commas and are enclosed by a pair of brackets ( [ ] ). 

Note 

A list can contain the elements of the same type or mixed types. For example, the fol¬ 
lowing list is fine: 

list4 = [2, "three", 4] 

10.2.2 List Is a Sequence Type 

Strings and lists are sequence types in Python. A string is a sequence of characters, while a list 
is a sequence of any elements. The common operations for sequences are summarized in 
Table 10.1. These operations for strings were introduced in Chapter 8. The sequence opera¬ 
tions for lists are the same as for strings. Sections 10.2.3-10.2.8 give examples of using these 
operations for lists. 



c/k, 
P ^Poi 


Key 

Point 


index 


VideoNote 

Use lists 


Table 10.1 Common Operations for Sequence s 

Operation Description 


X In s 
X not in s 
si -H s2 
s * n, n * s 
s[i] 

s[i : j] 

len(s) 

fflin(s) 

fflax(s) 

sum(s) 

for loop 

<, <=, >, >=, =, != 


True if element x is in sequence s. 

True if element x is not in sequence s. 

Concatenates two sequences si and s2. 
n copies of sequence s concatenated, 
ith element in sequence s. 

Slice of sequence s from index i to j — 1. 

Length of sequence s, i.e., the number of elements in s. 
Smallest element in sequence s. 

Largest element in sequence s. 

Sum of all numbers in sequence s. 

Traverses elements from left to right in a for loop. 
Compares two sequences. 
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1 en 
max 
mi n 
sum 

random.shuffle 


10.2.3 Functions for Lists 

Several Python built-in functions can be used with lists. You can use the Ten function to 
return the number of elements in the list, the max/mi n functions to return the elements with 
the greatest and lowest values in the list, and the sum function to return the sum of all ele¬ 
ments in the list. You can also use the shuf fl e function in the random module to shuffle the 
elements randomly in the list. Here are some examples; 


1 

»> 

listl = [2, 3, 4, 1, 32] 

2 

»> 

len(listl) 

3 

5 


4 

»> 

max(listl) 

5 

32 


6 

»> 

min(listl) 

7 

1 


8 

»> 

sum(listl) 

9 

42 


10 

»> 

import random 

11 

»> 

random.shuffle(listl) # Shuffle the elements in listl 

12 

»> 

1 i stl 

13 

[4, 

1, 2, 32, 3] 

14 

»> 




0 based 


Invoking random. shuf fl eCl i stl) (line 11) randomly shuffles the elements in 1 i stl. 


10.2.4 Index Operator [] 

An element in a list can be accessed through the index operator, using the following syntax: 
myList[index] 

List indexes are 0 based; that is, they range from 0 to len(myList)-l, as illustrated in 
Figure 10.1. 

myList = [5.6, 4.5, 3.3, 13.2, 4.0, 34.33, 34.0, 45.45, 99.993, 11123] 



Element value 


Figure 10.1 The list myLi st has 10 elements with indexes from 0 to 9. 


myLi St [index] can be used just like a variable, so it is also known as an indexed vari¬ 
able. For example, the following code adds the values in myList[0] and myList[l] to 
myLiSt[2]. 
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myList[2] = myList[0] + myListCl] 

The following loop assigns 0 to myList[0], 1 to myList[l], and 9 to 
myList[9]: 

for 1 in range(lenCmyLiSt)): 
myList[i] = i 


Caution 

Accessing a list out of bounds is a common programming error that results in a run¬ 
time IndexError. To avoid this error, make sure that you do not use an index 
beyond Ten (my Li St) - 1. 

Programmers often mistakenly reference the first element in a list with index 1, but it 
should be 0. This is called the off-by-one error. It is a common error in a loop to use <= 
where < should be used. For example, the following loop is wrong: 

i = 0 

while i <= 1 en(rtiyLiSt) : 
print(myList [i]) 
i -1-= 1 

The <= should be replaced by <. 

Python also allows the use of negative numbers as indexes to reference positions relative to 
the end of the list. The actual position is obtained by adding the length of the list with the 
negative index. For example: 



In line 2, listl[-l] is same as listl[-l -I- len(listl)], which gives the last ele¬ 
ment in the list. In line 4, listl[-3] is same as listl[-3 + len(listl)] , which gives 
the third last element in the list. 


10.2.5 List Slicing [start : end] 

The index operator allows you to select an element at the specified index. The slicing opera¬ 
tor returns a slice of the list using the syntax 1 ist[start : end]. The slice is a sublist 
from index start to index end - 1. Here are some examples: 


1 

»> 

11stl = 

[2, 3, 5, 7, 9, 1] 

2 

»> 

I1stl[2 

: 4] 

3 

[5, 

7] 


4 

»> 




The starting index or ending index may be omitted. In this case, the starting index is 0 and 
the ending index is the last index. For example: 


IndexError 


off-by-one error 


negative index 



slicing operator 

' 8 - 
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1 »> listl = [2, 3, 5, 2, 33, 21] 

2 »> ]istl[ : 2] 

3 [2, 3] 

4 »> ]istl[3 : ] 

5 [2, 33, 21] 

6 »> 


negative index 


Note that 1 iStic : 2] is the same as 1 istl[0 : 2] (line 2), and that 1 istlC3 : ] is 
the same as 11 St 1 [3 : len(l istl)] (line 4). 

You can use a negative index in slicing. For example: 


1 »> listl = [2, 3, 5, 2, 33, 21] 

2 »> listl[l : -3] 

3 [3, 5] 

4 »> listl[-4 : -2] 

5 [3, 5] 

6 »> 


In line 2, listlCl : -3] is the same as listl[l : -3 + len(listl)]. In line 4, 
listl[-4 : -2] is the same as listlC-4 + len(listl) : -2 + lenClistl)]. 

Note 

If start >= end, I i St [start : end] returns an empty list. If end specifies a 
position beyond the end of the list, Python will use the length of the list for end instead. 



10.2.6 The +, *, and in/not in Operators 

concatenation operator + You can use the concatenation operator (+) to join two lists and the repetition operator (*) to 

repetition operator * replicate elements in a list. Here are some examples: 


1 

»> 

li 

Stl 

= [2, 

3] 

2 

»> 

li 

st2 

= [1, 

9] 

3 

»> 

li 

st3 

= listl + list2 

4 

»> 

li 

st3 



5 

[2, 

3, 

1. 

9] 


6 

»> 





7 

»> 

li 

st4 

= 3 * 

1 i stl 

8 

»> 

li 

st4 



9 

[2, 

3, 

2, 

3, 2, 

3] 

10 

»> 







A new list is obtained by concatenating listl with list2 (line 3). Line 7 duplicates 
1 i stl three times to create a new list. Note that 3 * listl is the same as 1 i stl * 3. 

You can determine whether an element is in a list by using the i n or not i n operator. For 
example: 



»> listl = [2, 3, 5, 2, 33, 21] 
»> 2 in 1 istl 
T rue 
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»> 2 not in iistl 
Fal se 
»> 


10.2.7 Traversing Elements in a for Loop 

The elements in a Python list are iterable. Python supports a convenient for loop, which 
enables you to traverse the list sequentially without using an index variable. For example, the 
following code displays all the elements in the list myLi st: 

for u in myList: 
print(u) 

You can read the code as, “For each element u in myLi st, print it.” 

You still have to use an index variable if you wish to traverse the list in a different order or 
change the elements in the list. For example, the following code displays the elements at odd- 
numbered positions. 

for i in rangefO, len(myList), 2): 
printfmyList[i]) 


10.2.8 Comparing Lists 

You can compare lists using the comparison operators (>, >=, <, <=, ==, and ! =). For this to 
work, the two lists must contain the same type of elements. The comparison uses 
lexicographical ordering: the first two elements are compared, and if they differ this deter¬ 
mines the outcome of the comparison; if they are equal, the next two elements are compared, 
and so on, until either list is exhausted. Here are some examples: 


1 

»> listl 

= 

["qreen" 

, "red" 

"blue"] 

2 

»> list2 

= 

["red", 

"blue", 

"green"] 

3 

»> list2 

== 

listl 



4 

Fal se 





5 

»> list2 

! = 

listl 



6 

T rue 





7 

»> list2 

>= 

listl 



8 

Fal se 





9 

»> list2 

> 

1 i stl 



10 

Fal se 





11 

»> list2 

< 

1 i stl 



12 

T rue 





13 

»> list2 

<= 

listl 



14 

T rue 





15 

»> 







10.2.9 List Comprehensions 

List comprehensions provide a concise way to create a sequential list of elements. A list com¬ 
prehension consists of brackets containing an expression followed by a for clause, then zero 
or more for or i f clauses. The list comprehension produces a list with the results from eval¬ 
uating the expression. Here are some examples: 
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1 

»> listl = [x for X 

in range(5)] # Returns a list of 0, 1, 2, 3, 4 

2 

»> listl 



3 

[0, 1, 2, 3, 4] 



4 

»> 



5 

»> list2 = [0.5 * X 

for X in 

listl] 

6 

»> list2 



7 

[0.0, 0.5, 1.0, 1.5, 

2.0] 


8 

»> 



9 

»> list3 = [x for X 

in list2 

if X < 1.5] 

10 

»> list3 



11 

[0.0, 0.5, 1.0] 



12 

»> 





In line 1, 1 i stl is created from an expression using a for clause. The numbers in 1 i stl 
are 0, 1, 2, 3, and 4. Each number in 1 i st2 is half of the corresponding number in 1 i stl 
(line 5). In line 9, 1 i st3 consists of the numbers whose value is less than 1.5 in 1 i st2. 

10.2.10 List Methods 

Once a list is created, you can use the list class’s methods (shown in Figure 10.2) to manip¬ 
ulate the list. 


list 


append(x: object): None 

count(x: object): int 

extendfl: list): None 

indexfx: object): int 

insertfindex: int, x: object): 
None 

pop(i): object 


remove(x: object): None 
reverseC): None 
sort(): None 


Adds an element x to the end of the list. 

Returns the number of times element x appears in the list. 

Appends all the elements in 1 to the list. 

Returns the index of the first occurrence of element x in the list. 

Inserts an element x at a given index. Note that the first element in 
the list has index 0. 

Removes the element at the given position and returns it. The 
parameter i is optional. If it is not specified, list.pop() removes 
and returns the last element in the list. 

Removes the first occurrence of element x from the list. 

Reverses the elements in the list. 

Sorts the elements in the list in ascending order. 


Figure 10.2 The list class contains methods for manipulating a list. 


Here are some examples that use the append, count, extend, index, and insert methods: 


1 

»> 

listl = [2, 3, 4, 1, 32, 

4] 



2 

»> 

1istl.append(19) 




3 

»> 

listl 




4 

[2, 

3, 4, 1, 32, 4, 19] 




5 

»> 

1istl.count(4) # Return 

the 

count 

for number 4 

6 

2 





7 

»> 

list2 = [99, 54] 




8 

»> 

1istl.extend(list2) 




9 

»> 

1 i stl 




10 

[2, 

3, 4, 1, 32, 4, 19, 99, 

54] 



11 

»> 

1istl.index(4) # Return 

the 

i ndex 

of number 4 

12 

2 
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13 

»> 

1istl.insertfl, 25) 

# Insert 

25 at position index 1 

14 

»> 

listl 



15 

[2, 

25, 3, 4, 1, 32, 4, 

19, 99, 

54] 

16 

»> 





Line 2 appends 19 to the list, and line 5 returns the count of the number of occurrences 
of element 4 in the list. Invoking 1 istl.extendO (line 8) appends list2 to listl. 
Line 11 returns the index for element 4 in the list, and line 13 inserts 2 5 into the list at 
index 1. 

Here are some examples that use the insert, pop, remove, reverse, and sort 
methods: 


1 

»> 

listl = [2, 25, 3, 4, 1, 32, 4, 19, 99, 54] 

2 

»> 

1istl.pop(2) 

3 

3 


4 

»> 

listl 

5 

[2, 

25, 4, 1, 32, 4, 19, 99, 54] 

6 

»> 

1 i stl. popO 

7 

54 


8 

»> 

listl 

9 

[2, 

25, 4, 1, 32, 4, 19, 99] 

10 

»> 

1istl.remove(32) # Remove number 32 

11 

»> 

listl 

12 

[2, 

25, 4, 1, 4, 19, 99] 

13 

»> 

1istl.reverseO # Reverse the list 

14 

»> 

listl 

15 

[99 

19, 4, 1, 4, 25, 2] 

16 

»> 

listl.sortO # Sort the list 

17 

»> 

listl 

18 

[1. 

2, 4, 4, 19, 25, 99] 

19 

»> 




Line 2 removes the element at index 2 from the list. Invoking listl.pop () (line 6) 
returns and removes the last element from 1 istl. Line 10 removes element 32 from 1 istl, 
line 13 reverses the elements in the list, and line 15 sorts the elements in the list in ascending 
order. 

10.2.11 Splitting a String into a List 

The str class contains the spl i t method, which is useful for splitting items in a string into a 
list. For example, the following statement: 

items = "Jane John Peter Susan" . split() 

splits the string Jane John Peter Susan into the list ['Jane' , 'John' , 'Peter' , 

' Susan ' ] . In this case the items are delimited by spaces in the string. You can use a nonspace 
delimiter. For example, the following statement: 

items = "09/20/2012". spl it("/") 

splits the string 09/20/2012 into the list [' 09 ' , '20', '2012']. 
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regular expressions 



Note 

Python supports regular expressions, an extremely useful and powerful feature for 
matching and splitting a string using a pattern. Regular expressions are complex for 
beginning students. For this reason, we cover them in Supplement II.A, Regular 
Expressions. 


10.2.12 Inputting Lists 

You may often need code that reads data from the console into a list. You can enter one data 
item per line and append it to a list in a loop. For example, the following code reads ten num¬ 
bers one per line into a list. 

1st = [] # Create a list 
printC'Enter 10 numbers: ") 
for i in rangeClO): 

1 St .append(eval (inputO) 


Sometimes it is more convenient to enter the data in one line separated by spaces. You can 
use the string’s spl i t method to extract data from a line of input. For example, the following 
code reads ten numbers separated by spaces from one line into a list. 

# Read numbers as a string from the console 

s = inputC'Enter 10 numbers separated by spaces from one line: ") 

items = s.splitO # Extract items from the string 

1st = [eval(x) for x in items] # Convert items to numbers 


Invoking input() reads a string. Using s.splitC) extracts the items delimited by 
spaces from string s and returns items in a list. The last line creates a list of numbers by con¬ 
verting the items into numbers. 


10.2.13 Shifting Lists 

Sometimes you need to shift the elements left or right. Python does not provide such 
a method in the list class, but you can write the following function to perform a left 
shift. 

def shift(lSt): 

temp = lst[0] # Retain the first element 

# Shift elements left 

for i in range (1, len(lst)): jst 

lst[i - 1] = lst[i] 

# Move the first element to fill in the last position 
lst[len(lst) - 1] = temp 

10.2.14 Simplifying Coding 

Lists can be used to greatly simplify coding for certain tasks. For example, suppose you 
wish to obtain the English month name for a given month in number. If the month 
names are stored in a list, the month name for a given month can be accessed simply 
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via index. The following code prompts the user to enter a month number and displays its 
month name: 


months = [']anuary", "February", "March", ..., "December"] 
monthNumber = eval (i nput("Enter a month number (1 to 12): ")) 
printC'The month is", months[monthNumber - 1]) 


If the months list is not used, you would have to determine the month name using a lengthy 
multi-way if-else statement as follows: 


if monthNumber == 0: 

printC'The month is January") 
el if monthNumber == 1: 

printC'The month is February") 

else: 

printC'The month is December") 


10.1 How do you create an empty list and a list with the three integers 1, 32, and 2? 

10.2 Given 1 st = [30, 1, 12, 14, 10, 0] , how many elements are in 1 st? What 
is the index of the first element in 1 st? What is the index of the last element in 1 st? 
What is 1 st [2] ? What is 1 st [-2] ? 


^Eheck 
w Point 

MyProgrammingLab" 


10.3 Given 1 st = [30, 1, 2, 1, 0] , what is the list after applying each of the fol¬ 
lowing statements? Assume that each line of code is independent. 


1st. appendC40) 

1st.i nsertfl , 43) 
lst.extend([l, 43]) 
1st. removeCl) 

1st. popCl) 

Ist.popO 
1 st. sortO 
1 st. reverseO 
random.shufflefl st) 


10.4 Given 1st = [30, 1, 2, 1, 0] , what is the return value of each of the following 
statements? 

1st.i ndex(l) 

1st. count(l) 
len(lst) 
max(lst) 
mi n(l st) 
sum(lst) 

10.5 Given listl = [30, 1, 2, 1, 0]andlist2 = [1, 21, 13], what is the 
return value of each of the following statements? 

listl + list2 
2 * list2 
list2 * 2 
listl[l : 3] 

1i stl[3] 


0 
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10.6 Given listl = [30, 1, 2, 1, 0] , what is the return value of each of the fol¬ 
lowing statements? 

[x for X in listl if x > 1] 

[x for X in rangefO, 10, 2)] 

[x for X in rangeflO, 0, -2)] 

10.7 Given listl = [30, 1, 2, 1, 0]andlist2 = [1, 21, 13] , what is the 
return value of each of the following statements? 

listl < list2 
listl <= list2 

listl == list2 

listl != Iist2 

listl > list2 
listl >= list2 

10.8 Indicate true or false for the following statements: 

(a) Every element in a list must have the same type. 

(b) A list’s size is fixed after it is created. 

(c) A list can have duplicate elements. 

(d) The elements in a list can be accessed via an index operator. 

10.9 What are listl and 1 i st2 after the following lines of code? 

listl = [1, 43] 
list2 = listl 
listlfO] = 22 

10.10 What are listl and 1 i st2 after the following lines of code? 

listl = [1, 43] 

list2 = [x for X in listl] 

listlfO] = 22 

10.1 I How do you obtain a list from a string? Suppose si is welcome. What is 
sl.splitC'o')? 

10.12 Write statements to do the following: 

(a) Create a list with 100 Boolean Fal se values. 

(b) Assign the value 5.5 to the last element in the list. 

(c) Display the sum of the first two elements. 

(d) Compute the sum of the first five elements in the list. 

(e) Find the minimum element in the list. 

(f) Randomly generate an index and display the element of this index in the list. 

10.1 3 What happens when your program attempts to access a list element with an invalid 
index? 

10.14 What is the output of the following code? 

1st = [1, 2, 3, 4, 5, 6] 
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for i in range(l, 6): 
lst[i] = lst[i - 1] 


print(lSt) 


10.3 Case Study: Lotto Numbers 


The problem is to write a program that detennines whether all the input numbers 
cover 1 to 99. 



Each ticket for the Pick-10 lotto has 10 unique numbers ranging from 1 to 99. Suppose 
you buy a lot of tickets and like to have them cover all the numbers from 1 to 99. Write a 
program that reads the ticket numbers from a file and determines whether all numbers are 
covered. Assume the last number in the file is 0. Suppose the file contains the following 
numbers: 

80 3 87 62 30 90 10 21 46 27 

12 40 83 9 39 88 95 59 20 37 

80 40 87 67 31 90 11 24 56 77 
11 48 51 42 8 74 1 41 36 53 
52 82 16 72 19 70 44 56 29 33 

54 64 99 14 23 22 94 79 55 2 

60 86 34 4 31 63 84 89 7 78 
43 93 97 45 25 38 28 26 85 49 

47 65 57 67 73 69 32 71 24 66 

92 98 96 77 6 75 17 61 58 13 

35 81 18 15 5 68 91 50 76 


0 


Your program should display 

The tickets cover all numbers 

Suppose the file contains the numbers 

11 48 51 42 8 74 1 41 36 53 
52 82 16 72 19 70 44 56 29 33 
0 

Your program should display 

The tickets don't cover all numbers 

How do you mark a number as covered? You can create a list with 99 Boolean elements. 
Each element in the list can be used to mark whether a number is covered. Let the list be 
isCovered. Initially, each element is Fal se, as shown in Eigure 10.3a. Whenever a number 
is read, its corresponding element is set to True. Suppose the numbers entered are 1, 2, 3, 99, 
and 0. When number 1 is read, i sCovered[0] is set to True (see Eigure 10.3b). When num¬ 
ber 2 is read, i sCovered [2 - 1] is set to True (see Eigure 10.3c). When number 3 is read, 
isCovered[3 - 1] is set to True (see Eigure 10.3d). When number 99 is read, 
isCovered[98] is set to True (see Figure 10.3e). 

The algorithm for the program can be described as follows: 


for each number k read from the file, 

mark number k as covered by setting isCovered[k - 1] true 
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isCovered 


isCovered 


isCovered 


isCovered 


isCovered 


[0] 

False 

[0] 

True 

[0] 

True 

[0] 

True 

[0] 

True 

[1] 

False 

[1] 

False 

[1] 

True 

[1] 

True 

[1] 

True 

[2] 

False 

[2] 

False 

[2] 

False 

[2] 

True 

[2] 

True 

[3] 

False 

[3] 

False 

[3] 

False 

[3] 

False 

[3] 

False 











[97] 

False 

[97] 

False 

[97] 

False 

[97] 

False 

[97] 

False 

[98] 

False 

[98] 

False 

[98] 

False 

[98] 

False 

[98] 

True 


(a) (b) 


(c) 


(d) (e) 


Figure 10.3 If number i appears in a Lotto ticket, isCovered [i - 1] is set to true. 


create and initialize list 


read input line 


get input numbers 


mark number covered 


check all Cove red? 


if every isCovered[i] is true: 

The tickets cover all numbers 

el se: 

The tickets don't cover all numbers 
The complete program is given in Listing 10.2. 

Listing 10.2 LottoNumbers. py 

1 # Create a list of 99 Boolean elements with value False 

2 isCovered = 99 * [False] 

3 endOfInput = False 

4 while not endOfInput: 

5 # Read numbers as a string from the console 

6 s = inputC'Enter a line of numbers separated by spaces: ") 

7 items = s.splitO # Extract items from the string 

8 1st = [eval(x) for x in items] # Convert items to numbers 

9 

10 for number in 1st: 

11 if number == 0: 

12 endOfInput = True 

13 else: 

14 # Mark its corresponding element covered 

15 i sCovered[number - 1] = True 

16 

17 # Check whether all numbers (1 to 99) are covered 

18 all Covered = True # Assume all covered initially 

19 for i in range (..<9): 

20 if not isCovered[i]: 

21 allCovered = False # Find one number not covered 

22 break 

23 

24 # Display result 

25 if allCovered: 

26 printC'The tickets cover all numbers") 

27 else: 

28 printC'The tickets don't cover all numbers') 
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Enter a line of numbers separated by spaces: 256543 
Enter a line of numbers separated by spaces; 23 43 2 0 p 
The tickets don't cover all numbers 

-j Enter | 

iter 



Enter a line of numbers separated by spaces; 1 2 3 4 5 6 | 

Enter a line of numbers separated by spaces; 7 8 9 10 11 EnteT] 




The tickets cover all numbers 


Suppose you have created a text file named LottoNumbers.txt that contains the following 
input data: 256543 23 43 20 

You can run the program by using the following command from the command window: 

python LottoNumbers.py < LottoNumbers.txt 

The program creates a list of 99 Boolean values with the initial value Fal se (line 2). It 
repeatedly reads a line of numbers (line 6), extracts the numbers from the line (lines 7-8). For 
each number, the program performs the following operations in a loop: 

■ If the number is 0, set endOfInput True (line 12). 

■ If the number is not zero, set its corresponding value for isCovered to True 
(line 15). 

When the number is 0, the input ends (line 4). The program determines whether all num¬ 
bers are covered in lines 18-22 and displays the result in lines 25-28. 


10.4 Case Study: Deck of Cards 

The problem is to write a program that picks 4 cards randomly from a deck of 52 cards. 

All the cards can be represented using a list named deck, filled with initial values 0 to 51, as 
follows: 


tr/Key 
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deck = [x for x in range(52)] 

Or, you can use: 

deck = 1i st(range(52)) 

Card numbers 0 to 12, 13 to 25, 26 to 38, and 39 to 51 represent 13 spades, 13 hearts, 13 
diamonds, and 13 clubs, respectively, as shown in Figure 10.4. cardNumber // 13 deter¬ 
mines the suit of the card and cardNumber % 13 determines the rank of the card, as shown 
in Figure 10.5. After shuffling the deck, pick the first four cards from deck. The program dis¬ 
plays the cards from these four card numbers. 

Listing 10.3 gives the solution to the problem. 


Listing 10.3 DeckOf Cards. py 

1 # Create a deck of cards 

2 deck = [x for x in range(52)] 


create list deck 
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0 


12 

13 


25 

26 


38 

39 


51 


deck 


deck 


[0] 

0 

[0] 

6 

. 


[1] 

48 

> 13 Spades (id) 


[2] 

11 

■ 


[3] 

24 

[12] 

12 

[4] 


[13] 

13 

[5] 


13 Hearts (») 




[25] 

25 

Random shuffle [25] 


[26] 

26 

* [26] 


> 13 Diamonds (♦) 




[38] 

38 

[38] 


[39] 

39 

[39] 


> 13 Clubs (*) 




[51] 

51 

[51] 



Figure 10.4 Fifty-two cards are stored in a list named deck. 


Card number 6 is the 
7 (6 % 13 = 6) of 
Spades (7 //13 is 0) 

Card number 48 is the 
10 (48 % 13 = 9) of 
Clubs (48 //13 is 3) 

Card number 11 is the 
Queen (11 % 13 = 11) of 
Spades (11 //13 is 0) 

Card number 24 is the 
Queen (24 % 13 = 11) of 
Hearts (24 //13 is 1) 


cardNumber //13 = < 


0 

1 

2 

3 


Spades 

Hearts 

Diamonds 

Clubs 


0 

1 


cardNumber % 13 = ^ 


10 

11 

12 


Ace 

2 


Jack 

Queen 

King 


Figure 10.5 A card number identifies to a card. 


list of strings 
list of strings 


# Create suits and ranks lists 

suits = ['Spades", "Hearts", "Diamonds", "Clubs'] 
ranks = ["Ace", "2", "3", "4", "5", "6", "7", "8"^ 
"10", "Jack", "Queen", "King'] 



9 

# Shuffle the cards 



10 

import random 


shuffle deck 

11 

random.shufflefdeck) 



12 




13 

# Display the first four 

cards 


14 

for i in range (4); 


suit of a card 

15 

suit = suits[deck[i] 

// 13] 

rank of a card 

16 

rank = ranks[deck[i] 

% 13] 


17 

printC'Card number". 

deck[i] 


■9", 


'is the' , rank, ’of" , suit) 


Card number 6 is the 7 of Spades 
Card number 48 is the 10 of Clubs 

Card number 11 is the Queen of Spades 

Card number 24 is the Queen of Hearts 
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The program creates a deck of 52 cards (line 2), a list suits for the four suits (line 5), and 
a list ranks for the 13 cards in a suit (lines 6-7). The elements in suits and ranks are 
strings. 

The deck is initialized with the values 0 to 51. A deck value 0 represents the ace of 
spades, 1 represents the 2 of spades, 13 represents the ace of hearts, and 14 represents the 2 
of hearts. 

Lines 10-11 randomly shuffle the deck. After the deck is shuffled, deck[i] contains an 
arbitrary value. deck[i] // 13 is 0, 1, 2, or 3, which determines the suit (line 15); 
deck[i] % 13 is a value between 0 and 12, which determines the rank (line 16). 

If the suits list is not defined, you would have to determine the suit using a lengthy if 
statement as follows: 

if deck[i] // 13 == 0: 

printC'suit is Spades") 
elif deck[i] // 13 == 1: 

printC'suit is Hearts") 
elif deck[i] // 13 == 2: 

printC'suit is Diamonds") 
el se: 

printC'suit is Clubs") 

Withsuits = ["Spades", "Hearts", "Diamonds", "Clubs"] defined in a list, 
suits [deck // 13] gives the suit for the deck. Using lists greatly simplifies the solution 
for this program. 

10.5 Deck of Cards GUI 

The program picks 4 cards randomly from a deck of 52 cards and displays the 
cards. 

This section presents a GUI program that lets the user click the Shuffle button to display four 
random cards graphically on the console, as shown in Figure 10.6. 


tc/Key 
C? Point 




Figure 10.6 Clicking the Shuffle button displays four cards randomly. 


You can use Turtle or Tkinter to develop GUI programs in Python. Turtle is a good ped¬ 
agogical tool for introducing the fundamentals of programming, but its capability is lim¬ 
ited to drawing lines, shapes, and text strings. For developing comprehensive GUI 
projects, you should use Tkinter. From now on, we will use Tkinter in our GUI examples. 
Listing 10.4 gives the GUI program for creating the Shuffle button and displaying the four 
cards randomly. 

Listing 10.4 DeckOfCardsGUI. py 

1 from tkinter import * # Import ail definitions from tkinter 

2 import random 

3 
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4 class DeckOfCardsCUI: 

5 def _ init_(self): 

6 window = Tk() # Create a window 

7 window.titleC 'Pick Four Cards Randomly") # Set title 

8 


image list 

9 

self.imageList = [] # Store images for cards 


10 

for i in range(l, 53): 

add images to list 

11 

self.imageList.append(PhotoImage(file = "image/card/" 


12 

+ str(i) + .gif")) 


13 



14 

frame = Frame(window) # Hold four labels for cards 


15 

frame.pack() 


16 


label list 

17 

self.1abelLi St = [] # A list of four labels 


18 

for i in range( ): 

create labels 

19 

self.1abelList.append(Label(frame, 


20 

image = self.imageList[i])) 


21 

self.1abelLi St[i].pack(si de = LEFT) 


22 


create a button 

23 

Button(window, text = "Shuffle", 


24 

9 c: 

command = self.shuffle).pack() 


c j 

26 

window.mainloopO # Create an event loop 


27 



28 

# Choose four random cards 


29 

def shuffle(self): 

random shuffle 

30 

random.shuffle(self.imageList) 


31 

for i in range (4): 

set new images 

32 

self.1abelList[i] ["image"] = self.imageList[i] 


33 



34 

DeckOfCardsCUI0 # Create GUI 


The program creates 52 images from the image files stored in the image/card folder in 
the current program directory (lines 9-12). The files are named l.gif, 2.gif, ..., and 52.gif. 
The images are added to imageList. Each image is an instance of the Photoimage 
class. 

The program creates a frame to hold four labels (lines 14-15). The labels are added to 
label List (lines 17-21). 

The program creates a button (line 23). When the button is clicked, the shuffle function 
is invoked to randomly shuffle the image list (line 30) and set the first four images in the list 
as the labels (lines 31-32). 


rr-i^Key 
V' /Point 


10.6 Copying Lists 

To copy the data in one list to another list, you have to copy individual elements from 
the source list to the target list. 


You often need to duplicate a list or part of a list in a program. In such cases you could attempt 
to use the assignment statement (=), as follows: 


list2 = listl 


However, this statement does not copy the contents of the list referenced by listl to 
copy reference listZ; instead, it merely copies the reference value from listl to listZ. After this 

statement, listl and listZ refer to the same list, as shown in Figure 10.7. The list 
garbage collection previously referenced by 1 i st2 is no longer referenced; it becomes garbage. The memory 

space occupied by listZ will be automatically collected and reused by the Python 
interpreter. 
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Before the assignment 
list2 = listl 


listl 


Contents 
of 1 i stl 


list2 


Contents 
of 1 i St2 



Figure 10.7 Before the assignment statement, 11 stl and 1 i st2 point to separate memory 
locations. After the assignment, the listl reference value is passed to 1 i st2. 


Here is an example to illustrate the concept: 


1 »> listl = [1, 2] 

2 »> list2 = [3, 4, 5] 

3 »> id(listl) 

4 36207312 

5 »> id(list2) 

6 36249848 

7 »> 

8 »> list2 = listl 

9 »> id(list2) 

10 36207312 

11 »> 


Two lists are created (lines 1-2) and each is an independent object with a different id (lines 
4 and 6). After assigning listl to list2, list2’s id is the same as listl’s (line 10). 
listl and 1 i st2 now refer to the same object. 

To get a duplicate copy of 1 i stl into 1 i st2, you can use: 

list2 = [x for X in listl] 

or simply: 

list2 = [] + listl 

10.15 What is the output of the following code? 

listl = 1i st(range(l , 10, 2)) 
list2 = listl 
listlLO] = 111 
print(listl) 
print(list2) 

10.16 What is the output of the following code? 

listl = 1i st(range(l , 10, 2)) 
list2 = [] + listl 
listlLO] = 111 
print(l i stl) 
print(list2) 
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10.7 Passing Lists to Functions 

When passing a list to a function, the contents of the list may change after the function 
call, since a list is a mutable object. 


Since list is an object, passing a list to a function is just like passing an object to a function. 
For example, the following function displays the elements in a list: 


def printList(lSt): 

for element in 1st: 
print(element) 

You can invoke it by passing a list. For instance, the following statement invokes the 
printList function to display 3, 1, 2, 6, 4, and 2. 

printList( [3 , 1, 2, 6, 4, 2]) 


Note 

The preceding statement creates a list and passes it to the function. There is no explicit 
anonymous list reference variable for the list. Such a list is called an anonymous list. 

Since a list is a mutable object, the contents of a list may change in the function. Take the code 
immutable vs. mutable in Listing 10.5, for example: 



immutable object 
mutable object 


Listing 10.5 PassListArgument.py 

1 def mai n () : 

2 x=l#xisanint variable 

3 y = [1, 2, 3] # y is a list 

4 

5 m(x, y) # Invoke m with arguments x and y 

6 

7 printC'x is", x) 

8 print("y[0] is", y[0]) 

9 

10 def m(number, numbers): 

11 number = 1001 # Assign a new value to number 

12 numbers [0] = 5555 # Assign a new value to numbers[0] 

13 

14 mainO # Call the main function 


X i s 1 
y[0] is 5555 


In this sample run, you see that after m is invoked (line 5, x remains 1, but y[0] is 
changed to 5555. This is because y and numbers refer to the same list object. When mCx, y) 
is invoked, the reference values of x and y are passed to number and numbers. Since y 
contains the reference value to the list, numbers now contains the same reference value to 
the same list. Since number is immutable, altering it inside a function creates a new 
instance and the original instance outside the function is not changed. So, outside of the 
function, x is still 1. 
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There is another issue we need to address regarding using a list as a default argument. Con¬ 
sider the code in Listing 10.6. 

Listing 10.6 DefaultListArgument.py 

1 def add(x, 1st = []) : 

2 if X not in 1st: 

3 Ist.append(x) 

4 

5 return 1st 

6 

7 def mai n O : 

8 listl = add(l) 

9 print(listl) 

10 

11 list2 = add(2) 

12 print(list2) 

13 

14 list3 = add(3, [11, 12, 13, 14]) 

15 print(list3) 

16 

17 list4 = add (4) 

18 print(list4) 

19 

20 mainO 


[ 1 ] 

[ 1 , 2 ] 

[11, 12, 13, 14, 3] 
[1, 2, 4] 


The function add appends x to list 1 st if x is not in the list (lines 1-5). When the function 
is executed for the first time (line 8), the default value [] for the argument 1 st is created. 
This default value is created only once. addCl) adds 1 to 1 st. 

When the function is called again (line 11), 1 st is now [1] not [] , because 1 st is created 
only once. After add (2) is executed, 1 st becomes [1, 2] . 

In line 14, the list argument [11, 12, 13 , 14] is given, and this list is passed to 1 st. 

In line 17, the default list argument is used. Since the default list now is [1, 2], after 

invoking add (4), the default list becomes [1, 2, 4] . 

If you want the default list to be [] for every function call, you can revise the function as 
shown in Listing 10.7. 

Listing 10.7 DefaultNoneListArgument.py 

1 def add(x, 1st = None): 

2 if 1st == None: 

3 1st = [] 

4 if X not in 1st: 

5 Ist.append(x) 

6 

7 

8 


default argument 




default argument 
new empty list 


return 1st 
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9 

def mainO : 


10 

1 i stl = 

add(l) 

11 

pri nt(l i 

stl) 

12 



13 

list2 = 

add(2) 

14 

pri nt(l i 

st2) 

15 



16 

list3 = 

add(3 , 

17 

pri nt(l i 

st3) 

18 



19 

list4 = 

add (4) 

20 

pri nt(l i 

st4) 

21 



22 

main() 





Here a new empty list is created every time the add function is called without a list 
argument (line 3). If the list argument is given when invoking the function, the default list 
is not used. 


create a list 


return list 




10.8 Returning a List from a Function 

When a function returns a list, the list’s reference value is returned. 

You can pass list arguments when invoking a function. A function can also return a list. For 
example, the following function returns a list that is the reversal of another list. 


1 def reverse(lSt): 

2 result = [] 

3 

4 for element in 1st: 

5 result.i nsert(0, element) 

6 

7 return result 


1st l|l | l I I I 

result I I I |fr ] 


Line 2 creates a new list resul t. Lines 4-5 copy elements from the list named 1 st to the 
list named resul t. Line 7 returns the list. For example, the following statement returns a new 
list 1 ist2 with the elements 6, 5, 4, 3, 2, and 1. 

listl = [1, 2, 3, 4, 5, 6] 
list2 = reverse(listl) 


Note that the list class has the method reverse () that can be invoked to reverse a list. 
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10.17 True or false? When a list is passed to a function, a new list is created and passed to 
the function. 

10.18 Show the output of the following two programs: 












10.9 Case Study: Counting the Occurrences of Each Letter 335 


def man n(): 


def main(): 

number = 0 


1st = [1, 2, 3, 4, 5] 

numbers = [10] 


reverseflst) 



for value in 1st: 

m(number, numbers) 


printfvalue, end = ' ') 

pri ntC'number is'L number, 


def reverseflst): 

"and numbers[0] is", 


newLst = len(lst) * [0] 

numbers [0] ) 





for i in rangeflen(lst)): 

def m(x, y): 


newLst[i] = lst[len(lst) - 1 - i] 

X = 3 



y[0] = 3 


1st = newLst 

mai n () 


mai n() 


(a) (b) 


10.19 Show the output of the following two programs: 


def mai n() : 


def mai n() : 

listl = m(l) 


listl = m(l) 

print(listl) 


print(l i stl) 

listZ = m(l) 


list2 = m(l) 

print(list2) 


print(list2) 

def m(x, 1st = [1, 1, 2, 3]): 


def m(x, 1st = None): 

if X in 1st: 


if 1st == None: 

1st.remove(x) 


1st = [1, 1, 2, 3] 

return 1st 





if X in 1st: 

mai n() 


1st.remove(x) 



return 1st 



mai n() 


(a) (b) 


10.9 Case Study: Counting the Occurrences 
of Each Letter 


The program in this section counts the occurrence of each letter among 100 letters. 

Listing 10.8 presents a program that counts the occurrences of each letter in a list of charac¬ 
ters. The program does the following: 


^>^Key 
P / Point 


1. Generates 100 lowercase letters randomly and assigns them to a list of characters, 
named chars, as shown in Figure 10.8a. You can obtain a random letter by using the 

getRandomLowerCaseLetterC) function in the RandomCharacter module in 
Listing 6.11. 
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chars[0] 
chars [1] 


chars[98] 
chars[99] 


(a) 


counts[0] 
counts[1] 

counts[24] 
counts[25] 


(b) 


Figure 10.8 The chars list stores 100 characters, and the counts list stores 26 counts, 
each of which counts the occurrences of a letter. 


2. Counts the occurrences of each letter in the list. To do so, it creates a list named counts 
that has 26 int values, each of which counts the occurrences of a letter, as shown in 
Figure 10.8b. That is, counts [0] counts the number of times a appears in the list, 
counts [1] counts the number of time b appears, and so on. 


create list 


pass list chars 


return list counts 


pass list counts 


Listing 10.8 CountLettersInList.py 

1 import RandomCharacter # Defined in Listing 6.11 

2 

3 def mai n () : 

4 # Create a list of characters 

5 chars = createListO 

6 

7 # Display the list 

8 printC'The lowercase letters are:") 

9 displayList(chars) 

10 

11 # Count the occurrences of each letter 

12 counts = countLetters(chars) 

13 

14 # Display counts 

15 print(’'The occurrences of each letter are:') 

16 displayCounts(counts) 

17 

18 # Create a list of characters 

19 def createList(): 

20 # Create an empty list 

21 chars = [] 

22 

23 # Create lowercase letters randomly and add them to the list 

24 for i in range(lOO): 

25 chars.append(RandomCharacter.getRandomLowerCaseLetterO) 

26 

27 # Return the list 

28 return chars 

29 

30 # Display the list of characters 

31 def displayList(chars): 

32 # Display the characters in the list with 20 on each line 

33 for i in range(len(chars)): 

34 if (i + 1) % 20 == 0: 

35 print(chars[i]) 
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36 else: 

37 print(chars[i], end = ' ') 

38 

39 # Count the occurrences of each letter 

40 def countLetters(chars): 

41 # Create a list of 26 integers with initial value 0 

42 counts = 26 * [*)] 

43 

44 # For each lowercase letter in the list, count it 

45 for i in range(len(chars)): 

46 counts[ord(chars[i]) - ord('a')] += 1 

47 

48 return counts 

49 

50 # Display counts 

51 def displayCounts(counts): 

52 for i in range(len(counts)): 

53 if (i + 1) % 10 == 0: 

54 print(counts[i], chr(i + ord('a'))) 

55 else: 

56 print(counts[i], chr(i + ord('a')), end = ') 

57 

58 mainO # Call the main function 


The 

lowercase letters are: 



e y 

1 s r i b k 

j V j h 

a b z n w b 

t 

V 

s c 

c k r d w a 

m p w V 

u n q a m p 

1 

0 

a z 

g d e g f 1 

n d X m 

Z 0 U 1 0 z 

j 

V 

h w 

1 w n t g X 

w c d 0 

t X h y V z 

y 

z 

q e 

a m f w p g 

u q t r 

e n n w f c 

r 

f 

The 

occurrences 

of each 

letter are: 



5 a 

3 b 4 c 4 d 

4 e 4 f 

4 g 3 h 3 i 

3 

j 

2 k 

3 1 4 m 6 n 

4 0 3 p 

3 q 4 r 2 s 

4 

t 

3 u 

5 V 8 w 3 X 

3 y 6 z 





The createList function (lines 19-28) generates a list of 100 random lowercase letters. 
Line 5 invokes the function and assigns the list to chars. What would be wrong if you 
rewrote the code as follows? 

chars = 100 * [' ] 

chars = createListO 

You would be creating two lists. The first line would create a list by using 100 * [' ' ] . 
The second line would create a list by invoking createListO and assign the reference of 
the list to chars. The list created in the first line would become garbage because it would no 
longer be referenced. Python automatically collects garbage behind the scenes. Your program 
would compile and run correctly, but it would create a list unnecessarily. 

Invoking getRandomLowerCaseLetterO (line 25) returns a random lowercase letter. 
This function is defined in the RandomCharacter class in Listing 6.11. 

The countLetters function (lines 40-48) returns a list of 26 int values, each of which 
stores the number of occurrences of a letter. The function processes each letter in the list and 


counts 
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increases its count by one. A brute-force approach to count the occurrences of each letter 
might be as follows: 


for 1 in rangeflen(chars)): 
if chars[i] == 'a' : 

counts [0] += 1 
elif charsLi] == 'b': 
counts [1] += 1 


But a better solution is given in lines 45-46. 

for i in range(len(chars)): 

counts[ordfchars[i]) - ord('a')] += 1 

If the letter (chars[i]) is a, the corresponding count is counts[ord('a') 
ordC'a')] (i.e., counts[0]). If the letter is b, the corresponding count is 
counts[ord('b') - ord('a')] (i.e., counts[1]), since the Unicode of b is one more 
than that of a. If the letter is z, the corresponding count is counts[ordC'z') 
ord('a')] (i.e., counts[25]), since the Unicode of z is 25 more than that of a. 



VideoNote 

Search a list 


linear searches 
binary searches 


10.10 Searching Lists 

A If a list is sorted, a binary search is more efficient than a linear search for finding an 

f element in the list. 

Searching is the process of looking for a specific element in a list—for example, discover¬ 
ing whether a certain score is included in a list of scores. The list class provides the 
i ndex method for searching and returning the index of a matching element from a list. 
It also supports the i n and not i n operators for determining whether an element is in 
a list. 

Searching is a common task in computer programming. Many algorithms are devoted to 
searching. This section discusses two commonly used approaches: linear searches and binary 
searches. 


10.10.1 The Linear Search Approach 

The linear search approach compares the key element key sequentially with each element in 
the list. It continues to do so until the key matches an element in the list or the list is exhausted 
without a match being found. If a match is found, the linear search returns the matching ele¬ 
ment’s index in the list. If no match is found, the search returns -1. The 1 i nearSearch func¬ 
tion in Listing 10.9 illustrates this approach. 


0 

linear search animation on 
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Listing 10.9 Li nearSearch, 


# The function for finding a key 
def linearSearchflst, key): 
for i in range(len(lst)): 
if key == lst[i]: 

return i 

return -1 


py 

in the list 


[ 0 ] [ 1 ] [ 2 ] ... 

ith I I I I II 

key Compare key with lst[i] for i = 0,1, 
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To better understand this function, trace it with the following statements: 


1st 

= [1, 4, 4, 2, 5, 

-3, 

6, 

2] 

i = 

linearSearch(lst, 

4) 

# 

Returns 1 

j = 

linearSearch(lst, 

-4) 

# 

Returns -1 

k = 

linearSearch(lst, 

-3) 

# 

Returns 5 


The linear search function compares the key with each element in the list. The elements can 
be in any order. On average, the algorithm will have to examine half of the elements in a list 
before finding the key, if it exists. Since the execution time of a linear search increases linearly 
as the number of list elements increases, doing a linear search is inefficient for a large list. 


e 

binary search animation on 
Companion Website 

■ If the key is less than the list’s middle element, you need to continue to search for the 
key only in the first half of the list. 

■ If the key is equal to the list’s middle element, the search ends with a match. 

■ If the key is greater than the list’s middle element, you need to continue to search for 
the key only in the second half of the list. 


10.10.2 The Binary Search Approach 

A binary search is the other common search approach for a list of values. For a binary search 
to work, the elements in the list must already be ordered. Assume that the list is in ascending 
order. A binary search first compares the key with the element in the middle of the list. Consider 
the following three cases: 


Note 

Clearly, the binary search function eliminates half of the list after each comparison. 
Sometimes you eliminate half of the elements, and sometimes you eliminate half plus 
one. Suppose that the list has n elements. For convenience, let n be a power of 2. After 
the first comparison, n/2 elements are left for further search; after the second compari¬ 
son, (n/2)/2 elements are left. After the /cth comparison, n/2^ elements are left for further 
search. When k = log 2 n, only one element is left in the list, and you need only one more 
comparison. Therefore, in the worst-case scenario when using the binary search 
approach, you need log 2 n-i-l comparisons to find an element in the sorted list. In the 
worst case for a list of 1024 (2*°) elements, the binary search requires only 11 compar¬ 
isons, whereas a linear search requires 1,023 comparisons in the worst case. 

The portion of the list being searched shrinks by half after each comparison. Let 1 ow and 
high denote, respectively, the first index and last index of the list that is currently being 
searched. Initially, low is 0 and high is len(lst)-l. Let mid denote the index of the mid¬ 
dle element, so mid is (low -I- high) // 2. Figure 10.9 shows how to find the key 11 in the 
list [2, 4, 7, 10, 11, 45, 50, 59, 60, 66, 69, 70, 79] using a binary search. 

You now know how a binary search works. The next task is to implement it in Python. 
Don’t rush to create a complete implementation. Develop it incrementally, one step at a time. 
You can start with the first iteration of the search, as shown in Figure 10.10a. It compares the 
key with the middle element in the list, whose 1 ow index is 0 and high index is 1 en(1 st) - 
l.Ifkey < lst[mid], set the high index to mid - l;ifkey == 1 st [mid], a match is 
found and the program returns mid; if key > 1 st [mid], set the low index to mid -i- 1. 

Next, consider implementing the function to perform a search repeatedly by adding a loop, 
as shown in Figure 10.10b. The search ends if the key is found, or if the key is not found when 
low > high. 
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key is 11 
key < 50 


key > 7 


key ==11 


low mid high 

III 

[0] [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] 


2 

4 

7 

10 

11 

45 50 59 60 66 69 70 79 

low 


mi d 



hi gh 

1 


1 



1 

[0] 

[1] 

[2] 

[3] 

[4] 

[5] 

2 

4 

7 

10 

11 

45 



1 

OW 

mi c 

high 




\ 

1 

/ 




[3] 

[4] 

[5] 




10 

11 

45 


Figure 10.9 A binary search eliminates half of the list from further consideration after each 
comparison. 


def binarySearch(lst, key): 
low = 0 

high = len(lst) - 1 


def binarySearch(lst, key): 
low = 0 

high = len(lst) - 1 

mid = (low + high) // 2 


while high >= low: 

if key < lst[mid]: 

high = mid - 1 
el if key == 1st[mid]: 

return mid 
el se: 

low = mid + 1 


mid = (low + high) // 2 
if key < 1st[mid]: 

high = mid - 1 
el if key == 1st[mid]: 

return mid 
else: 

low = mid + 1 



return 1 # Not found 


(a) Version 1 (b) Version 2 


Figure 10.10 A binary search is implemented incrementally. 


When the key is not found, 1 ow is the insertion point where a key would be inserted to 
why not -1? maintain the order of the list. It is more useful to return the insertion point than -1. The func¬ 

tion must return a negative value to indicate that the key is not in the list. Can it simply return 
-1 ow? No. If the key is less than 1 st [0] , 1 ow would be 0. -0 is 0. This would indicate that 
the key matches 1 st [0] . A good choice is to let the function return -low - 1 if the key is 
not in the list. Returning -low - 1 indicates not only that the key is not in the list, but also 
where the key would be inserted. 

The complete program appears in Listing 10.10. 

Listing 10.10 Bi narySearch. py 

1 # Use binary search to find the key in the list 

2 def binarySearchflst, key): 

3 low = 0 

4 high = len(lst) - 1 

5 

6 while high >= low: 

7 mid = (low + high) // 2 

8 if key < 1st[mid]: 
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9 high = mid - 1 

10 el if key == 1st[mid]: 

11 return mid 

12 else : 

13 low = mid + 1 

14 

15 return -low - 1 # Now high < low, key not found 

The binary search returns the index of the matching element if it is contained in the list 
(line 11). Otherwise, it returns -low - 1 (line 15). 

What would happen if we replaced (high >= low) in line 6 with (high > low)? The 
search would miss a possible matching element. Consider a list with just one element: The 
search would miss the element. 

Does the function still work if there are duplicate elements in the list? Yes, as long as the 
elements are sorted in increasing order, the function returns the index of one of the matching 
elements if the element is in the list. 

To better understand this function, trace it with the following statements and identify 1 ow 
and high when the function returns. 

1st = [2, 4, 7, 10, 11, 45, so, 59, 60, 66, 69, 70, 79] 
i = binarySearch(lst, 2) # Returns 0 
j = binarySearch(lst, 11) # Returns 4 
k = binarySearch(lst, 12) # Returns -6 
1 = binarySearch(lst, 1) # Returns -1 
m = binarySearch(lst, 3) # Returns -2 

The following table shows the low and high values when the function exits and also 
shows the value returned from invoking the function. 


Function 


Low 

High 

Value Returned 

bi narySearchfl st, 

2) 

0 

1 

0 

bi narySearchCl st, 

11) 

3 

5 

4 

bi narySearchfl st, 

12) 

5 

4 

-6 

bi narySearchfl st, 

1) 

0 

-1 

-1 

bi narySearchCl st, 

3) 

1 

0 

-2 



Note 

Linear searches are useful for finding an element in a small list or an unsorted list, but 
they are inefficient for large lists. Binary searches are more efficient, but they require that 
the list be presorted. 


10.11 Sorting Lists 

There are many strategies for sorting elements in a list. Selection sorts and insertion 
sorts are two common approaches. 

Sorting, like searching, is a common task in computer programming. The list class provides 
the sort method for sorting a list. 

Many different algorithms have been developed for sorting. This section introduces two 
simple, intuitive sorting algorithms: selection sort and insertion sort. By using these algo¬ 
rithms, you will learn valuable techniques for developing and implementing other algorithms. 


first haff 
matched 
second haff 


binary search benefits 

Y" / Point 

seiection sort 
insertion sort 
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0 

selection sort animation on 
Companion Website 


10.II.I Selection Sort 

Suppose that you want to sort a list in ascending order. A selection sort finds the smallest ele¬ 
ment in the list and swaps it with the first element. It then finds the smallest element remaining 
and swaps it with the first element in the remaining list, and so on, until only a single element 
remains. Figure 10.11 shows how to sort the list [2, 9, 5, 4, 8, 1, 6] using a selection sort. 


Select 1 (the smallest) and swap it 
with 2 (the first) in the list. 


The number 1 is now in the 
correct position and thus no 
longer needs to be considered. 

The number 2 is now in the 
correct position and thus no 
longer needs to be considered. 

The number 4 is now in the 
correct position and thus no 
longer needs to be considered. 

The number 5 is now in the 
correct position and thus no 
longer needs to be considered. 

The number 6 is now in the 
correct position and thus no 
longer needs to be considered. 


The number 8 is now in the 
correct position and thus no 
longer needs to be considered. 


swap 

{ ^ } 

2 9 5 4 8 1 6 

swap 

{ ^ } 

1 9 5 4 8 2 6 

swap 

\ '} 

1 2 5 4 8 9 6 


1 2 4 5 8 9 6 

swap 

1 2 4 5 8 9 6 

swap 

1 2 4 5 6 9 8 


1 2 4 5 6 8 9 


Select 2 (the smallest) and swap it 
with 9 (the first) in the remaining 
list. 


Select 4 (the smallest) and swap it 
with 5 (the first) in the remaining 
list. 


5 is the smallest and in the right 
position. No swap is necessary. 


Select 6 (the smallest) and swap it 
with 8 (the first) in the remaining 
list. 


Select 8 (the smallest) and swap it 
with 9 (the first) in the remaining 
list. 


Since there is only one element 
remaining in the list, the sort is 
completed. 


Figure 10.11 A selection sort repeatedly selects the smallest element and swaps it with the first element in the remain¬ 
ing list. 


It can be difficult to develop a complete sorting solution on the first attempt. Start by writing 
the code for the first iteration to find the smallest element in the list and swap it with the first ele¬ 
ment, and then observe what would be different for the second iteration, the third, and so on. The 
insight this gives you will enable you to write a loop that generalizes all the iterations. 

The solution can be described as follows: 

for i in rangeflen(lst)-1): 

select the smallest element in lst[i : len(lst)] 
swap the smallest with lst[i], if necessary 

# lst[i] is in its correct position. 

# The next iteration applies to lst[i+l : len(lst)] 

Listing 10.11 implements the solution. 

Listing 10.11 SelectionSort.py 

1 # The function for sorting elements in ascending order 

2 def selectionSort(lst): 

3 for i in range(len(lst) - 1): 





10.11 Sorting Lists 343 


4 # Find the minimum in the lst[i : ien(lst)] 

5 currentMin = lst[i] 

6 currentMinindex = i 

7 


8 

for j in rangefi + 1, len(lst)) : 

select 

9 

if currentMin > ist[j]: 


10 

currentMin = ist[j] 


11 

12 

currentMinindex = j 


13 

# Swap lst[i] with 1st[currentMinindex] if necessary 


14 

if currentMinindex != i: 


15 

ist[currentMinIndex] = ist[i] 

swap 

16 

lst[i] = currentMin 



The selectionSortClSt) function sorts any list of elements. The function is imple¬ 
mented with a nested for loop. The outer loop (with the loop control variable i) (line 3) is 
iterated in order to find the smallest element in the list, which ranges from lst[i] to 
1 st[len(l st)-l], and exchanges it with 1 st[i]. 

The variable ” is initially 0. After each iteration of the outer loop, IstCi] is in the 
right place. Eventually, all the elements are put in the right place; therefore, the whole list 
is sorted. 

To understand this function better, trace it with the following statements: 

1st = [1, 9, 4.5, 10.6, 5.7, -4.5] 

selectionSort(lst) 


10.11.2 Insertion Sort 

Suppose that you want to sort a list in ascending order. The insertion-sort algorithm sorts a list 
of values by repeatedly inserting a new element into a sorted sublist until the whole list is 
sorted. Figure 10.12 shows how to sort the list [2, 9, 5, 4, 8, 1, 6] using an insertion sort. 


m 

insertion sort animation on 
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Step 1: Initially, the sorted sublist contains the 2 9 5 4 8 1 6 

first element in the list. Insert 9 into the sublist. 


Step 2: The sorted sublist is [2, 9]. Insert 5 into 
the sublist. 


2 



4 


1 6 


Step 3: The sorted sublist is [2, 5, 9]. Insert 4 into 2 5— >-9—>-4 8 16 

the sublist. 


Step 4: The sorted sublist is [2, 4, 5, 9]. Insert 8 
into the sublist. 


rn 

2 4 5 9^ 8 16 


Step 5: The sorted sublist is [2, 4, 5, 8, 9]. Insert 2>-1 >- 5 >- ;; >' 9 > l 6 

1 into the sublist. 


Step 6: The sorted sublist is [1, 2, 4, 5, 8, 9]. 1 2 4 5 8^-9^-6 

Insert 6 into the sublist. 


Step 7: The entire list is now sorted. 1 2 4 5 6 8 9 

Figure 10.12 An insertion sort repeatedly inserts a new element into a sorted sublist. 
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The algorithm can be described as follows: 

for 1 in rangeCl, len(lst)): 

insert ist[i] into a sorted sublist ist[0 : i] so that 
ist[0..i+l] is sorted. 

To insert lst[i] into lst[0..i-l], save lst[i] into a temporary variable, say 
currentElement. Move 1st [i-1] tolst[i] iflst[i-l] > currentElement; move 
lst[i-2] to lst[i-l] if lst[i-2] > currentElement; and so on, until 1 st[i-k] <= 
currentElement or k > i (we pass the first element of the sorted list). Assign 
currentElement to lst[i-k+l]. For example, to insert 4 into [2, 5, 9] in Step 3 in 
Figure 10.13, move 1st [2] (9) to 1st [3] since 9 > 4, and move lst[l] (5) to 1st [2] 
since 5 > 4. Finally, move currentElement (4) to 1 st[l]. 


[0][1][2][3][4][5][6] 

1st I 2 5 9 4 ~| Step 1: Save 4 to the temporary variable currentEI ement. 

currentElement: [3 

[0][1][2][3][4][5][6] 

1st I 2 5 9 ~| Step 2: Move 1 St [2] to 1 St [3] . 


[0][1][2][3][4][5][6] 

1st I 2 5 9 ~| Step 3: Move 1 St [1] to 1 St [2] . 

[0][1][2][3][4][5][6] 

1st I 2 4 5 9 I Step 4: Assign currentElement to 1st[1] . 

Figure I O.I 3 A new element is inserted into a sorted sublist. 


The algorithm can be expanded and implemented as in Listing 10.12. 


shift 


insert 


Listing 10.12 InsertionSort.py 

1 # The function for sorting elements in ascending order 

2 def i nsertionSortfl st) : 

3 for i in range(l, len(lst)): 

4 # insert lst[i] into a sorted sublist lst[0 : i] so that 

5 # lst[0 : i+1] is sorted. 

6 currentElement = lst[i] 

7 k = i - 1 

8 while k >= 0 and lst[k] > currentElement: 

9 lst[k + 1] = lst[k] 

10 k -= 1 

11 

12 # Insert the current element into lst[k + 1] 

13 lst[k + 1] = currentElement 

The insertionSortClSt) function sorts any list of elements. The function is imple¬ 
mented with a nested for loop. The outer loop (with the loop control variable i) (line 3) is 
iterated in order to obtain a sorted sublist, which ranges from 1 st [0] to 1 st [i ] . The inner 
loop (with the loop control variable k) inserts lst[i] into the sublist from lst[0] to 
lst[i-l]. 

To better understand this function, trace it with the following statements: 

1st = [1, 9, 4.5, 10.6, 5.7, -4.5] 
insertionSort(lst) 
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10.20 Use Figure 10.8 as an example to show how to apply the binary search approach to 
a search for key 10 and key 12 in the list [2, 4, 7, 10, 11, 45, 50, 59, 60, 66, 69, 

70, 79]. 

10.21 If the binary search function returns -4, is the key in the list? Where should the key 
be inserted if you wish to insert the key into the list? 

10.22 Use Figure 10.10 as an example to show how to apply the selection-sort approach to 
sort [3.4, 5, 3, 3.5, 2.2, 1.9, 2]. 

10.23 Use Figure 10.11 as an example to show how to apply the insertion-sort approach to 
sort [3.4, 5, 3, 3.5, 2.2, 1.9, 2]. 

10.24 How do you modify the selectionSort function in Listing 10.11 to sort elements 
in decreasing order? 

10.25 How do you modify the insertionSort function in Listing 10.12 to sort elements 
in decreasing order? 


/Check 
{. Point 

MyProgrammingLab" 


10.12 Case Study: Bouncing Balls 

The program in this section displays bouncing balls stored in a list. 

Now let’s put things we have learned into developing an interesting project. The program 
we’ll write in this section displays bouncing balls, as shown in Figure 10.14a. 


r-ipS 



(a) 


Ball 


x: int 


The X-, y-coordinates for the center of the 

y: int 


ball. By default, it is (0, 0). 

dx: int 


dx and dy are the increments for (x, y). 

dy: int 



color: str 


The color of the ball. 

radius: int 


The radius of the ball. 


(b) 


Figure 10.14 (a) The program displays bouncing balls with control buttons, (b) The Bal 1 class encapsulates informa¬ 
tion about the ball. 


The program enables the user to click the + and — buttons to add a ball or remove a ball 
from the canvas, and click the Stop and Resume buttons to stop the ball movements or 
resume them. 

Each ball has its own center location (x, y), radius, color, and next increment for its the Ball class 
center position, dx and dy. You can define a class to encapsulate all this information, as 
shown in Figure 10.14b. Initially, the ball is centered at (0, 0), and dx = 2 and dy = 2. In the 
animation, the ball is moved to (x -r dx, y + dy). When the ball reaches the right boundary, 
change dx to -2. When the ball reaches the bottom boundary, change dy to -2. When the ball 
reaches the left boundary, change dx to 2. When the ball reaches the top boundary, change dy 
to 2. The program simulates a bouncing ball by changing the dx or dy values when the ball 
touches the boundary of the canvas. 

When the -I- button is clicked, a new ball is created. How do you store the ball in the pro¬ 
gram? You can store the balls in a list. When the — button is clicked, the last ball in the list is 
removed. 
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The complete program is given in Listing 10.13. 


Listing 10.13 BounceBal 1 s. py 



1 

from tkinter import * # Import all definitions from tkinter 


2 

from random import randint 


4 

# Return a random color string in the form #RRCGBB 

random color 

5 

def getRandomColor(); 


6 

color = „ 


7 

for j in range('): 


8 

color += toHexChar(randi nt(0, 15)) # Add a random digit 


9 

return color 


10 



11 

# Convert an integer to a single hex digit in a character 

random hex number 

12 

def toHexChar(hexValue): 


13 

if 0 <= hexValue <= 9: 


14 

return chr(hexValue + ord('O')) 


15 

else: # 10 <= hexValue <= 15 


16 

return chr(hexValue - 10 + ord('A')) 


17 



18 

# Define a Ball class 

Bal 1 class 

19 

class Bal1: 


20 

def _ init_(self): 


21 

self.x = 0 # Starting center position 


22 

self.y = 0 


23 

self.dx = 2 # Move right by default 


24 

self.dy = 2 # Move down by default 


25 

self.radius = 3 # The radius is fixed 


26 

self.color = getRandomColorO # Get random color 


27 



28 

class BounceBalIs: 


29 

def _ init_(self): 

ball list 

30 

self.ball Li St = [] # Create a list for balls 


31 



32 

window = Tk() # Create a window 


33 

window.title( 'Bouncing Balls") # Set a title 


34 



35 

self.width = 350 # Width of the self.canvas 


36 

self.height = 150 # Height of the self.canvas 

create canvas 

37 

self.canvas = Canvas(window, bg = "white", 


38 

width = self.width, height = self.height) 


39 

self.canvas.pack() 


40 



41 

frame = Frame(window) 


42 

frame.pack() 

create buttons 

43 

btStop = Button(frame, text = "Stop", command = self.stop) 


44 

btStop.pack(side = LEFT) 


45 

btResume = Button(frame, text = "Resume", 


46 

command = self.resume) 


47 

btResume.pack(side = LEFT) 


48 

btAdd = Button(frame, text = "+", command = self.add) 


49 

btAdd.pack(side = LEFT) 


50 

btRemove = Button(frame, text = command = self.remove) 


51 

btRemove.pack(side = LEFT) 


52 


sleep time 

53 

self.sleepTime = 100 # Set a sleep time 

isStopped? 

54 

self.isStopped = False 


55 

self.animate 0 


56 
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57 window.mainloopO # Create an event loop 

58 

59 def stop(self): # Stop animation 

60 self.isStopped = True 

61 

62 def resume(self): # Resume animation 

63 self.isStopped = False 

64 self .animateO 

65 

66 def add(self): # Add a new ball 

67 self.ballList.append(Ball ()) 

68 

69 def remove(self): # Remove the last ball 

70 self .ballList.popO 

71 

72 def animate(self): # Animate ball movements 

73 while not self.isStopped: 

74 self.canvas.after(self.sleepTime) # Sleep 

75 self.canvas.updateO # Update self.canvas 

76 self.canvas. deleteC'ball') 

77 

78 for ball in self.ballList: 

79 sel f.redisplayBal1(bal1) 

80 

81 def redisplayBal1(self, ball): 

82 if ball.x > self.width or ball.x < 0: 

83 ball.dx = -ball.dx 

84 

85 if ball.y > self.height or ball.y < 0: 

86 ball.dy = -ball.dy 

87 

88 bal1.X += bal1.dx 

89 bal1.y += bal1.dy 

90 self.canvas.create_oval(ball .X - ball.radius, 

91 ball.y - ball.radius, ball.x + ball.radius, 

92 ball.y + ball, radius, fill = ball, col or, tags = ‘'ball") 

93 

94 BounceBallsO # Create GUI 


stop 


resume 


add 


remove 


animate 


display ball 


create GUI 


The program creates a canvas for displaying balls (lines 35-39), creates the buttons Stop, 
Resume, +, and — (lines 43-51), and starts the animation (line 57). 

The animate method repaints the canvas every 100 milliseconds (lines 72-79). It redis¬ 
plays every ball in the ball list (lines 78-79). The redi spl ayBal 1 method changes the direc¬ 
tion for dx and dy if the ball touches any boundaries of the canvas (lines 82-86), sets a new 
center position for the ball (lines 88-89), and redisplays the ball on the canvas (lines 90-92). 

When the Stop button is clicked, the stop method is invoked to set the isStopped vari¬ 
able to True (line 60) and the animation stops (line 73). When the Resume button is clicked, 
the resume method is invoked to set the i sStopped variable to Fal se (line 63) and the ani¬ 
mation resumes (line 73). 

When the + button is clicked, the add method is invoked to add a new ball to the ball list 
(line 67). When the - button is clicked, the remove method is invoked to remove the last ball 
from the ball list (line 70). 

When a ball is created (line 67), the Ball ’s_ init_ method is invoked to create and 

initialize the properties x, y, dx, dy, radius, and color. The color is a string #RRGCBB, 
where R, C, B is a hex digit. Each hex digit is randomly generated (line 26). The 
toHexChar (hexVal ue) method returns a hex character for the value between 0 and 15 
(lines 12-16). 
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Chapter Summary 


1 . You can use the Python built-in functions 1 en, max, mi n, and sum to return the length 
of a list, the maximum and minimum elements in a list, and the sum of all the ele¬ 
ments in a list. 

2. You can use the shuf fl e function in the random module to shuffle the elements in a list. 

3. You can use the index operator [ ] to reference an individual element in a list. 

4. Programmers often mistakenly reference the first element in a list with index 1, but it 
should be 0. This is called the index off-by-one error. 

5. You can use the concatenation operator -i- to concatenate two lists, the repetition oper¬ 
ator * to duplicate elements, the slicing operator [: ] to get a sublist, and the i n and 
not 1 n operators to check whether an element is in a list. 

6. You can use a for loop to traverse all elements in a list. 

7. You can use the comparison operators to compare the elements of two lists. 

8. A list object is mutable. You can use the methods append, extend, insert, pop, 
and remove to add and remove elements to and from a list. 

9. You can use the i ndex method to get the index of an element in a list, and the count 
method to return the count of the element in the list. 

10. You can use the sort and reverse methods to sort or reverse the elements in a list. 

I I . You can use the split method to split a string into a list. 

12. When a function is invoked with a list argument, the reference of the list is passed to 
the function. 

13. If a list is sorted, a binary search is more efficient than a linear search for finding an 
element in the list. 

14. A selection sort finds the smallest number in the list and swaps it with the first ele¬ 
ment. It then finds the smallest number remaining and swaps it with the first element 
in the remaining list, and so on, until only a single number remains. 

1 5. The insertion-sort algorithm sorts a list of values by repeatedly inserting a new ele¬ 
ment into a sorted sublist until the whole list is sorted. 
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Test Questions 

Do test questions for this chapter online at www.cs.armstrong.edu/liang/py/test.html. 

Programming Exercises MyProgrammingLab" 


Note 

If the program prompts the user to enter a list of values, enter the values from one 
line separated by spaces. 

Sections 10.2-10.3 

*10.1 (Assign grades) Write a program that reads a list of scores and then assigns grades 
based on the following scheme: 

The grade is A if score is >= best - 10. 

The grade is B if score is >= best - 20. 

The grade is C if score is >= best - 30. 

The grade is D if score is >= best - 40. 

The grade is F otherwise. 

Here is a sample run: 



Enter scores: 40 55 70 58 Enter | 
Student 0 score is 40 and grade is C 

Student 1 score is 55 and grade is B 

Student 2 score is 70 and grade is A 

Student 3 score is 58 and grade is B 


10.2 (Reverse the numbers entered) Write a program that reads a list of integers and 
displays them in the reverse order in which they were read. 

**10.3 (Count occurrence of numbers) Write a program that reads some integers 
between 1 and 100 and counts the occurrences of each. Here is a sample run of 
the program: 


Enter integers between 1 and 100: 256543 23 43 2 enter 

2 occurs 2 times 

3 occurs 1 time 

4 occurs 1 time 

5 occurs 2 times 

6 occurs 1 time 
23 occurs 1 time 
43 occurs 1 time 



Note that if a number occurs more than one time, the plural word “times” is used 
in the output. 

10.4 (Analyze scores) Write a program that reads an unspecified number of scores and 
determines how many scores are above or equal to the average and how many 
scores are below the average. Assume the input numbers are separated by one 
space in one line. 
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** 10.5 {Print distinct numbers) Write a program that reads in numbers separated by a 
space in one line and displays distinct numbers (i.e., if a number appears mul¬ 
tiple times, it is displayed only once). (Hint: Read all the numbers and store 
them in 1 istl. Create a new list 1 ist2. Add a number in 1 istl to 1 ist2. 
If the number is already in the list, ignore it.) Here is the sample run of the 
program: 




Enter ten numbers: 1232163452 
The distinct numbers are: 123645 


*10.6 {Revise Listing 5.13, PrimeNumberpy) Listing 5.13 determines whether a number 
n is prime by checking whether 2, 3, 4, 5, 6, ..., n/2 is a divisor for n. If a divisor 
is found, n is not prime. A more efficient approach is to check whether any of the 
prime numbers less than or equal to A/n can divide n evenly. If not, n is prime. 
Rewrite Listing 5.13 to display the first 50 prime numbers using this approach. 
You need to use a list to store the prime numbers and later use them to check 
whether they are possible divisors for n. 

*10.7 {Count single digits) Write a program that generates 1,000 random integers 
between 0 and 9 and displays the count for each number. (Hint: Use a list of ten 
integers, say counts, to store the counts for the number of Os, Is, ..., 9s.) 

Sections 10.4-10.7 

10.8 {Find the index of the smallest element) Write a function that returns the index of 
the smallest element in a list of integers. If the number of such elements is greater 
than 1, return the smallest index. Use the following header: 

def 1 ndexOfSmal 1 estElement(lSt): 

Write a test program that prompts the user to enter a list of numbers, invokes this 
function to return the index of the smallest element, and displays the index. 

* 10.9 {Statistics: compute deviation) Exercise 5.46 computes the standard deviation of 
numbers. This exercise uses a different but equivalent formula to compute the 
standard deviation of n numbers. 


mean 



Xi + X2 + ■ ■ ■ + Xu 

n 


deviation = 



{Xi — meanf 


n — \ 


To compute the standard deviation with this formula, you have to store the 
individual numbers using a list, so that they can be used after the mean is 
obtained. 

Your program should contain the following functions: 


# Compute the standard deviation of values 
def deviation(x): 

# Compute the mean of a list of values 
def mean(x): 

Write a test program that prompts the user to enter a list of numbers and displays 
the mean and standard deviation, as shown in the following sample run: 
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Enter numbers; 1.9 2.5 3.7 2 1 6 3 4 5 2 ^nter 
The mean is 3.11 

The standard deviation is 1.55738 


*10.10 {Reverse a list) The reverse function in Section 10.8 reverses a list by copying it 
to a new list. Rewrite the function that reverses the list passed in the argument and 
returns this list. Write a test program that prompts the user to enter a list of num¬ 
bers, invokes the function to reverse the numbers, and displays the numbers. 

Section 10.8 

*10.1 I {Random number chooser) You can shuffle a list using random. shuf f 1 e(1 st) . 

Write your own function without using random. shuffleCl st) to shuffle a list 
and return the list. Use the following function header: 

def shuffle(lst): 

Write a test program that prompts the user to enter a list of numbers, invokes the 
function to shuffle the numbers, and displays the numbers. 

10.12 {Compute GCD) Write a function that returns the greatest common divisor 
(GCD) of integers in a list. Use the following function header; 

def gcd(numbers); 

Write a test program that prompts the user to enter five numbers, invokes the 
function to find the GCD of these numbers, and displays the GCD. 

Sections 10.9-10.12 

10.13 {Eliminate duplicates) Write a function that returns a new list by eliminating the 
duplicate values in the list. Use the following function header: 

def eliminateDuplicates(lst): 

Write a test program that reads in a list of integers, invokes the function, and dis¬ 
plays the result. Here is the sample run of the program: 


Enter ten numbers: 1232163452 Enter 
The distinct numbers are: 123645 


* 10.14 {Revise selection sort) In Section 10.11.1, you used selection sort to sort a list. 

The selection-sort function repeatedly finds the smallest number in the current 
list and swaps it with the first one. Rewrite this program by finding the largest 
number and swapping it with the last one. Write a test program that reads in ten 
numbers, invokes the function, and displays the sorted numbers. 

**I0.I5 {Sorted?) Write the following function that returns true if the list is already 
sorted in increasing order; 

def i sSortedflst): 

Write a test program that prompts the user to enter a list and displays whether the 
list is sorted or not. Here is a sample run: 
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**10.16 {Bubble sort) Write a sort function that uses the bubble-sort algorithm. The 
bubble-sort algorithm makes several passes through the list. On each pass, 
successive neighboring pairs are compared. If a pair is in decreasing order, 
its values are swapped; otherwise, the values remain unchanged. The tech¬ 
nique is called a bubble sort or sinking sort because the smaller values grad¬ 
ually “bubble” their way to the top and the larger values “sink” to the bottom. 
Write a test program that reads in ten numbers, invokes the function, and dis¬ 
plays the sorted numbers. 

**I0.I7 (Anagrams) Write a function that checks whether two words are anagrams. 

Two words are anagrams if they contain the same letters. For example, sil ent 
and 11 sten are anagrams. The header of the function is: 

def isAnagramfsl, s2): 

(Hint: Obtain two lists for the two strings. Sort the lists and check if two lists 
are identical.) 

Write a test program that prompts the user to enter two strings and, if they 
are anagrams, displays is an anagram; otherwise, it displays is not an 

anagram. 

***10.18 (Game: Eight Queens) The classic Eight Queens puzzle is to place eight 
queens on a chessboard such that no two queens can attack each other (i.e., no 
two queens are in the same row, same column, or same diagonal). There are 
many possible solutions. Write a program that displays one such solution. A 
sample output is shown below: 


Q 


Q 


Q 



Q 


Q 


Q 


***10.19 (Game: bean machine) The bean machine, also known as a quincunx or the 
Galton box, is a device for statistics experiments named after English scientist 
Sir Erancis Galton. It consists of an upright board with evenly spaced nails (or 
pegs) in a triangular pattern, as shown in Eigure 10.15. 

Balls are dropped from the opening of the board. Every time a ball hits a nail, 
it has a 50% chance of falling to the left or to the right. The piles of balls are 
accumulated in the slots at the bottom of the board. 
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Figure 10.15 Each ball takes a random path and falls into a slot. 


Write a program that simulates the bean machine. Your program should 
prompt the user to enter the number of the balls and the number of the slots in 
the machine. Simulate the falling of each ball by printing its path. For example, 
the path for the ball in Figure 10.15b is FLRRLLR and the path for the ball in 
Figure 10.15c is RLRRLRR. Display the final buildup of the balls in the slots 
in a histogram. Here is a sample run of the program: 


Enter the number of bails to drop: 5 |’^Enter| 

Enter the number of slots In the bean machine: 7 


LRLRLRR 

RRLLLRR 

LLRLLRR 

RRLLLLL 

LRLRRLR 


0 

0 

000 



(Hint: Create a list named slots. Each element in slots stores the number 
of balls in a slot. Each ball falls into a slot via a path. The number of Rs in a 
path is the position of the slot where the ball falls. For example, for the path 
LRLRFRR, the ball falls into slots[4], and for the path is RRLFLLF, the 
ball falls into si ots [2] .) 

***10.20 {Game: multiple Eight Queens solutions) Exercise 10.18 has you find one 
solution for the Eight Queens puzzle. Write a program to count all possible 
solutions for the Eight Queens problem and display all the solutions. 

** 10.21 {Game: locker puzzle) A school has 100 lockers and 100 students. All lockers 
are closed on the first day of school. As the students enter, the first student, 
denoted SI, opens every locker. Then the second student, S2, begins with the 
second locker, denoted L2, and closes every other locker. Student S3 begins 
with the third locker and changes every third locker (closes it if it was open, 
and opens it if it was closed). Student S4 begins with locker L4 and changes 
every fourth locker. Student S5 starts with L5 and changes every fifth locker, 
and so on, until student SI00 changes LI00. 
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After all the students have passed through the building and changed the lockers, 
which lockers are open? Write a program to find your answer. 

(Hint: Use a list of 100 Boolean elements, each of which indicates whether a 
locker is open (True) or closed (Fal se). Initially, all lockers are closed.) 

** 10.22 (Simulation: coupon collector’s problem) Coupon Collector is a classic statistics 
problem with many practical applications. The problem is to pick objects from a 
set of objects repeatedly and find out how many picks are needed for all the 
objects to be picked at least once. A variation of the problem is to pick cards from 
a shuffled deck of 52 cards repeatedly and find out how many picks are needed 
before you see one of each suit. Assume a picked card is placed back in the deck 
before picking another. Write a program to simulate the number of picks needed 
to get four cards, one from each suit and display the four cards picked (it is possi¬ 
ble a card may be picked twice). Here is a sample run of the program: 



Queen of Spades 
5 of Clubs 
Queen of Hearts 
4 of Diamonds 
Number of picks: 12 


10.23 (Algebra: solve quadratic equations) Write a function for solving a quadratic 
equation using the following header: 


def solveQuadratic(eqn, roots): 

The coefficients of a quadratic equation ax^ + bx + c = 0 are passed to the list 
eqn and the noncomplex roots are stored in roots. The function returns the 
number of roots. See Programming Exercise 4.1 on how to solve a quadratic 
equation. 

Write a program that prompts the user to enter values for a, b, and c and displays 
the number of roots and all noncomplex roots. 

* 10.24 (Math: combinations) Write a program that prompts the user to enter 10 integers 

and displays all the combinations of picking two numbers from the 10. 

* 10.25 (Game: pick four cards) Write a program that picks four cards from a deck of 52 

cards and computes their sum. An ace, king, queen, and jack represent 1, 13,12, 
and 11, respectively. Your program should display the number of picks that yield 
the sum of 24. 

** 10.26 (Merge two sorted lists) Write the following function that merges two sorted lists 
into a new sorted list: 


def mergeCIistl, Iist2): 

Implement the function in a way that takes 1 en (1 i stl) H- 1 en(1 i st2) com¬ 
parisons. Write a test program that prompts the user to enter two sorted lists and 
displays the merged list. Here is a sample run: 



Enter listl: 1 5 16 61 111 
Enter l'ist2: 2 4 5 6 | 

The merged 1ist is 1 2 4 5 5 6 16 61 111 
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*10.27 (Pattern recognition: four consecutive equal numbers) Write the following func¬ 
tion that tests whether the list has four consecutive numbers with the same value: 

def isConsecutiveFour(vaiues): 

Write a test program that prompts the user to enter a series of integers and reports 
whether the series contains four consecutive numbers with the same value. 

** 10.28 (Partition of a list) Write the following function that partitions the list using the 

first element, called a pivof. 

def partition(ist): 

After the partition, the elements in the list are rearranged so that all the ele¬ 
ments before the pivot are less than or equal to the pivot and the element after 
the pivot are greater than the pivot. The function also returns the index where 
the pivot is located in the new list. For example, suppose the list is [5, 2, 9, 3, 
6, 8]. After the partition, the list becomes [3, 2, 5, 9, 6, 8]. Implement the 
function in a way that takes len(lst) comparisons. Write a test program 
that prompts the user to enter a list and displays the list after the partition. 
Here is a sample run: 


Enter a list: 10 1 5 16 61 9 11 1 

After the partition, the 1ist is 9 1 5 1 10 61 11 16 



*** 10.29 (Game: hangman) Write a hangman game that randomly generates a word and 
prompts the user to guess one letter at a time, as shown in the sample run. Each 
letter in the word is displayed as an asterisk. When the user makes a correct 
guess, the actual letter is then displayed. When the user finishes a word, dis¬ 
play the number of misses and ask the user whether to continue playing. Create 
a list to store the words, as follows: 

# Use any words you wish 

words = ["write", "that", "program", ...] 


(Guess) Enter a letter in word ******* > p 

(Guess) Enter a letter in word p****** > r 

(Guess) Enter a letter in word pr**r** > p 

p is already in the word 
(Guess) Enter a letter in word pr**r** > o 

(Guess) Enter a letter in word pro*r** > g 

(Guess) Enter a letter in word progr** > n 

n is not in the word 

(Guess) Enter a letter in word progr** > m 

(Guess) Enter a letter in word progr*m > a 

The word is program. You missed 1 time 





Do you want to guess another word? Enter y or n> 


* 10.30 (Culture: Chinese Zodiac) Simplify Listing 4.5, ChineseZodiac.py, using a list 
of strings to store the animals’ names. 
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10.3 I (Occurrences of each digit in a string) Write a function that counts the occur¬ 
rences of each digit in a string using the following header: 

def count(s): 

The function counts how many times a digit appears in the string. The return 
value is a list of ten elements, each of which holds the count for a digit. For 
example, after executing counts = count("12203AB3"), counts[0] is 1, 
counts [1] is 1, counts [2] is 2, and counts [3] is 2. 

Write a test program that prompts the user to enter a string and displays the 
number of occurrences of each digit in the string. Here is a sample run of the 
program: 




Enter a string: 232534312 ^ 

1 occurs 1 time 

2 occurs 3 times 

3 occurs 3 times 

4 occurs 1 time 

5 occurs 1 time 


10.32 (Turtle: draw a line) Write the following function that draws a line from point 
pi ([xl, yl]) to point p2 ([x2, y2]). 

# Draw a line 

def drawLineCpl, p2): 

10.33 (Tkinter: draw histograms) Write a program that generates 1,000 lowercase let¬ 
ters randomly, counts the occurrence of each letter, and displays a histogram for 
the occurrences, as shown in Figure 10.16a. 


Count of Each Letter 




a b c d e f q h i j k I m n o p q r s t u v w x y z 
Display Histogram 



(a) 

Figure 10.16 (a) A histogram is drawn for the count of each letter, (b) Two buttons are 

added to control the ball speed. 


10.34 (Turtle: draw histograms) Rewrite the preceding program using Turtle. 

* 10.35 (Tkinter: bouncing balls) Revise Listing 10.13 to add two buttons— Faster and 
Slower, as shown in Figure 10.16b—to speed up or slow down the ball 
movements. 
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** I 0.36 (Tkinter: linear search animation) Write a program that animates the linear 
search algorithm. Create a list that consists of 20 distinct numbers from 1 to 
20 in a random order. The elements are displayed in a histogram, as shown in 
Figure 10.17. You need to enter a search key in the text field. Clicking the 
Step button causes the program to perform one comparison in the algorithm 
and repaints the histogram with a bar indicating the search position. When 
the algorithm is finished, display a dialog box to inform the user. Clicking the 
Reset button creates a new random list for a new start. 



Figure 10.17 The program animates a linear search. 


**10.37 {Tkinter: binary search animation) Write a program that animates the binary 
search algorithm. Create a list with the numbers from 1 to 20 in this order. The 
elements are displayed in a histogram, as shown in Figure 10.18. You need to 
enter a search key in the text field. Clicking the Step button causes the program 
to perform one comparison in the algorithm. Use a light-gray color to paint the 
bars for the numbers in the current search range and use a red color to paint the 
bar indicating the middle number in the search range. When the algorithm is 
finished, display a dialog box to inform the user. Clicking the Reset button 
enables a new search to start. This button also makes the text field editable. 


Rinarv <;Mrrh . 

9 


A 


15 

16 



19 

1 

Enter a key (in float): 3 Step 

1 Reset 1 




^■Rinary Search 

5 



13 





19 

1 


Enter a key (in float): 3 Step Reset 


(a) 


(b) 


Figure 10.18 The program animates a binary search. 


*10.38 {Tkinter: selection-sort animation) Write a program that animates the selection-sort 
algorithm. Create a list that consists of 20 distinct numbers from 1 to 20 in a ran¬ 
dom order. The elements are displayed in a histogram, as shown in Figure 10.19. 
Clicking the Step button causes the program to perform an iteration of the outer 
loop in the algorithm and repaints the histogram for the new list. Color the last bar 
in the sorted sublist. When the algorithm is finished, display a dialog box to inform 
the user. Clicking the Reset button creates a new random list for a new start. 
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(a) (b) 

Figure 10.19 The program animates a selection sort. 


* 10.39 (Tkinter: the 24-point card game) The 24-point card game involves picking any four 
cards from 52 cards, as shown in Figure 10.20. Note that the jokers are excluded. Each 
card represents a number. An ace, king, queen, and jack represent 1,13, 12, and 11, 
respectively. Enter an expression that uses the four numbers from the four selected 
cards. Each card number can be used only once in each expression, and each card 
must be used. You can use the operators (+, —, *, and /) and parentheses in the 
expression. The expression must evaluate to 24. After entering the expression, click 
the Verify button to check whether the numbers in the expression are currently selected 
and whether the result of the expression is correct. Display the verification in a dialog 
box. You can click the Refresh button to get another set of four cards. Assume that 
images are stored in files named l.gif, 2.gif, ..., 52.gif, in the order of spades, hearts, 
diamonds, and clubs. So, the first 13 images are for spades 1, 2, 3,..., and 13. 


24*Point 


! Refresh 




u ♦ 

K 

¥ 





♦ 

♦ ♦s 



A 

a 

♦ 

* 

♦ *L 

♦♦♦ 

♦♦♦ 

♦ ♦oi 


Enter an expression; (13 - 5) * (10 -T\ Verify 


24-Point Game 




» Refresh 

= ♦ ♦ 

K 

¥ 




'♦“V ' 



♦ 




4^ 

♦♦♦ 

♦ ♦♦ 


A 

a 

* 

♦ *01 





Enter an expression: ]l3 + 5 +7 -1 Verify 




Figure 10.20 The user enters an expression using the numbers in the cards. 
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* 1 0.40 {Tkinter: insertion-sort animation) Write a program that animates the insertion-sort 
algorithm. Create a list that consists of 20 distinct numbers from 1 to 20 in a ran¬ 
dom order. The elements are displayed in a histogram, as shown in Figure 10.21. 
Clicking the Step button causes the program to perform an iteration of the outer 
loop in the algorithm and repaints the histogram for the new list. Color the last bar 
in the sorted sublist. When the algorithm is finished, display a dialog box to inform 
the user. Clicking the Reset button creates a new random list for a new start. 



Figure 10.21 The program animates an insertion sort. 


10.41 {Display five circles) Write a program that displays five circles, as shown in 
Figure 10.22a. Enable the user to drag each circle using the mouse, as shown in 
Figure 10.22b. 



(a) 

Figure 10.22 Each circle can be dragged with the mouse. 
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CHAPTER 


11 

Multidimensional 

Lists 

objectives 

■ To learn how a two-dimensional list can represent two-dimensional data 

(§ 11 . 1 ). 

■ To access elements in a two-dimensional list by using row and column 
indexes (§11.2). 

■ To program common operations for two-dimensional lists (displaying lists, 
summing all elements, finding min and max elements, random 
shuffling, and sorting) (§11.2). 

■ To pass two-dimensional lists to functions (§11.3). 

■ To write a program for grading multiple-choice questions by using 
two-dimensional lists (§11.4). 

■ To solve the closest-pair problem by using two-dimensional lists 
(§§11.5-11.6). 

■ To check a Sudoku solution by using two-dimensional lists (§§11.7-11.8). 

■ To use multidimensional lists (§11.9). 
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I l.l Introduction 


r^Key 
»P / Point 

two-dimensional list 



VideoNote 

Process a matrix 


Data in a table or a matrix can be stored in a two-dimensional list. 

A two-dimensional list is a list that contains other lists as its elements. The preceding chapter 
introduced how to use a list to store linear collections of elements. You can use a list to store 
two-dimensional data, such as a matrix or a table, as well. For example, the following table, 
which provides the distances between cities, can be stored in a list named distances. 


Distance Table (in miles) 



Chicago 

Boston 

New York 

Atlanta 

Miami 

Dallas 

Houston 

Chicago 

0 

983 

787 

714 

1,375 

967 

1,087 

Boston 

983 

0 

214 

1,102 

1,505 

1,723 

1,842 

New York 

787 

214 

0 

888 

1,549 

1,548 

1,627 

Atlanta 

714 

1,102 

888 

0 

661 

781 

810 

Miami 

1,375 

1,505 

1,549 

661 

0 

1,426 

1,187 

Dallas 

967 

1,723 

1,548 

781 

1,426 

0 

239 

Houston 

1,087 

1,842 

1,627 

810 

1,187 

239 

0 


distances = [ 

[ , 983, 787, 714, 1375, 967, 1087], 
[983, 0, 214, 1102, 1505, 1723, 1842], 
[787, 214, 0, 888, 1549, 1548, 1627], 
[714, 1102, 888, 0, 661, 781, 810], 
[1375, 1505, 1549, 661, 0, 1426, 1187], 
[967, 1723, 1548, 781, 1426, 0, 239], 
[1087, 1842, 1627, 810, 1187, 239, 0] 


nested list 


Each element in the distances list is another list, so distances is considered a nested 
list. In this example, a two-dimensional list is used to store two-dimensional data. 


row index 
column index 


11.2 Processing Two-Dimensional Lists 

A value in a two-dimensional list can be accessed through a row and column index. 

Point You can think of a two-dimensional list as a list that consists of rows. Each row is a list that 
contains the values. The rows can be accessed using the index, conveniently called a row 
index. The values in each row can be accessed through another index, called a column index. 
A two-dimensional list named matrix is illustrated in Eigure 11.1. 


matrix 

= [ 




[-', 

2, 

3, 

4, 

5], 

[6, 

7, 

0, 

0, 

0], 

[0, 

1, 

0, 

0, 

0], 

[1. 

0, 

0, 

0, 

8], 

[0, 

0, 

9, 

0, 

3], 


[ 1 ] [ 2 ] [ 3 ] [ 4 ] 


, [ 0 ] 

1 

2 

3 

4 

5 

- [ 1 ] 

6 

7 

0 

0 

0 

’ [ 2 ] 

0 

1 

0 

0 

0 

’ [ 3 ] 

1 

0 

0 

0 

8 

[ 4 ] 

0 

0 

9 

0 

3 


matrix[0] is [1, 2, 3, 4, 5] 

matrix[1] is [6, 7, 0, 0, 0] 

matrix[2] is [0, 1, 0, 0, 0] 

matrix[3] is [1, 0, 0, 0, 8] 

matrix[4] is [0, 0, 9, 0, 3] 

matrix[0] [0] is 1 
matrix[4] [4] is 3 


Figure I l.l The values in a two-dimensional list can be accessed through row and column 
indexes. 
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Each value in matrix can be accessed using matrix[i] [j], where i and j are the row 
and column indexes. 

The following sections give some examples of using two-dimensional lists. 


11 . 2.1 Initializing Lists with Input Values 

The following loop initializes the matrix with user input values: 
matrix = [] # Create an empty list 

numberOfRows = eval(i nputC'Enter the number of rows: ")) 
numberOfCoiumns = eval(i nputC'Enter the number of columns: ")) 
for row in range(numberOfRows): 

matriX.appendC[]) # Add an empty new row 
for column in rangefnumberOfColumns): 

value = eval(i nputC'Enter an element and press Enter: ")) 
matrix[row].append(value) 

print(matrix) 


11.2.2 Initializing Lists with Random Values 

The following loop initializes a list that stores random values between 0 and 99: 

import random 

matrix = [] # Create an empty list 

numberOfRows = eval(i nputC'Enter the number of rows: ")) 
numberOfColumns = eval(i nputC'Enter the number of columns: ")) 
for row in range(numberOfRows): 

matriX.append([]) # Add an empty new row 
for column in range(numberOfColumns): 

matrix[row].appendfrandom. randintfO, 99)) 

print(matrix) 


11.2.3 Printing Lists 

To print a two-dimensional list, you have to print each element in the list by using a loop like 
the following: 

matrix = [[1, 2, 3], [4, 5, 6], [7, 8, 9]] # Assume a list is given 

for row in range(len(matrix)): 

for column in range(len(matrix[row])): 

print(matriX[row][column], end = ) 

printO # Print a new line 

Or you can write: 

matrix = [[1, 2, 3], [4, 5, 6], [7, 8, 9]] # Assume a list is given 

for row in matrix: 
for value in row: 

print(value, end = ") 

printO # Print a new line 
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11.2.4 Summing All Elements 

Use a variable named total to store the sum. Initially, total is 0. Add each element in the 
list to total by using a loop like this: 

matrix = [[1, 2, 3], [4, 5, 6], [7, 8, 9]] # Assume a list is given 

total = 0 
for row in matrix: 
for value in row: 
total += value 

printC'Total is", total) # Print the total 

11.2.5 Summing Elements by Column 

For each column, use a variable named total to store its sum. Add each element in the col¬ 
umn to total using a loop like this: 

matrix = [[1, 2, 3], [4, 5, 6], [7, 8, 9]] # Assume a list is given 

for column in range(len(matrix[0])) : 
total = 0 

for row in range(1en(matrix)): 

total += matrix[row][column] 
printC'Sum for column", column, 'is", total) 

11.2.6 Finding the Row with the Largest Sum 

To find the row with the largest sum, you may use the variables maxRow and 
i ndexOfMaxRow to track the largest sum and the index of the row. For each row, compute its 
sum and update maxRow and i ndexOfMaxRow if the new sum is greater. 

matrix = [[1, 2, 3], [4, 5, 6], [7, 8, 9]] # Assume a list is given 

maxRow = sum(matrix[0]) # Get sum of the first row in maxRow 
indexOfMaxRow = 0 

for row in rangefl, len(matrix)): 
if sum(matrix[row]) > maxRow: 
maxRow = sum(matrix[row]) 
indexOfMaxRow = row 

printU'Row", indexOfMaxRow, 'has the maximum sum of", maxRow) 

11.2.7 Random Shuffling 

You can shuffle the elements in a one-dimensional list by using the random.shuffle(1 ist) 
function, introduced in Section 10.2.3. How do you shuffle all the elements in a two-dimensional 
list? To accomplish this, for each element matrix [row] [col umn] , randomly generate indexes 

i and j and swap matrix [row] [column] with matrix[i] [j], as follows: 

import random 

matrix = [[1, 2, 3], [4, 5, 6], [7, 8, 9]] # Assume a list is given 

for row in range(len(matrix)): 

for column in range(len(matrix[row])): 

i = random.randi nt(0 , len(matrix) - 1) 
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j = random. randintCO, len(matrix[row]) - 1) 

# Swap matrix[row][column] with matrix[i][j] 
matrix[row][column], matrix[i][j] = \ 
matrix[i][j], matrix[row][column] 


print(matrix) 

I 1.2.8 Sorting 

You can apply the sort method to sort a two-dimensional list. It sorts the rows on their first 
elements. For the rows with the same first element, they are sorted on the second elements. If 
the first and second elements in the rows are the same, their third elements are sorted, and so 
on. For example, 

points = [[4, 2], [1, 7], [4, 5], [1, 2], [1, 1], [4, 1]] 
poi nts. sortO 
print(points) 

displays [[1, 1], [1, 2], [1, 7], [4, 1], [4, 2], [4, 5]]. 

I I. I How do you create a list for a two-dimensional set of data with three rows and four 
columns with values 0 ? 

11.2 Can you create a list for two-dimensional data with a different number of elements in 
a row? 

11.3 What is the output of the following code? 
matrix = [] 

matrix. appendCS * [1]) 
matrix. appendCS * [1]) 
matriX. appendCS * [1]) 
matri x [0] [0] = 2 
printfmatrix) 

I 1.4 What is the output of the following code? 
matrix = [] 

matrix. append([3 * [1]]) 
matrix. append([3 * [1]]) 
matrix. append([3 * [1]]) 
printfmatrix) 
matrix[0] = 3 
printfmatri x) 

11.5 What is the output of the following code? 
matrix = [] 

matrix. append([l, 2, 3]) 
matrix. append([4, 5]) 
matrix. append([6, 7, 8, 9]) 
print(matrix) 

11.3 Passing Two-Dimensional Lists to Functions 

When passing a two-dimensional list to a function, the list’s reference is passed to the 
function. 

You can pass a two-dimensional list to a function just as you pass a one-dimensional list. You 
can also return a two-dimensional list from a function. Listing 11.1 gives an example with two 
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getMatri x function 


return matrix 
accumul ate function 


get matrix 

invoke accumulate function 


^iCheck 

Point 

MyProgrammingLab" 


functions. The first function, getMatrixC), returns a two-dimensional list, and the second 
function, accumulate Cm), returns the sum of all the elements in a matrix. 

Listing 11.1 PassTwoDimensionalList.py 

1 def getMatrixC): 

2 matrix = [] # Create an empty list 

3 

4 numberOfRows = eval(i nput("Enter the number of rows: ")) 

5 numberOfColumns = eval(i nput("Enter the number of columns: ")) 

6 for row in range(numberOfRows): 

7 matrix.append([]) # Add an empty new row 

8 for column in range(numberOfColumns): 

9 value = eval (i nput("Enter a value and press Enter: ")) 

10 matrix[row].append(value) 

11 

12 return matrix 

13 

14 def accumulate(m): 

15 total = 0 

16 for row in m: 

17 total += sum(row) 

18 

19 return total 

20 

21 def mainO : 

22 m = getMatrixC) # Get a list 

23 print(m) 

24 

25 # Display sum of elements 

26 print("\nSum of all elements is", accumulate(m)) 

27 

28 mainO # Invoke main function 


Enter the number of rows: 2 I -I Entei^ 

Enter the number of columns: 2 [1 Enter| 
Enter a value and press Enter: 1 enter| 

Enter a value and press Enter: 2 

Enter a value and press Enter: 3 [ -I Enter | 

Enter a value and press Enter: 4 ||^Enter 

[[1, 2], [3, 4]] 

Sum of all elements is 10 


The function getMatri x (lines 1-12) prompts the user to enter values for the matrix (line 
9), and returns the list (line 12). 

The function accumulate (lines 14-19) has a two-dimensional list argument. It returns 
the sum of all elements in the list (line 26). 

I 1.6 Show the output of the following code: 
def f(m): 

for i in range(len(m)): 

for j in range(len(m[i])): 
m[i] [j] += 1 
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def printMCm): 

for i in range(1en(m)) : 

for j in range(len(m[i])): 

print(m[i][j], end = ) 

pri nt() 

m = [[0, 0] , [0, 1]] 

printM(m) 
f(m) 

printM(m) 


11.4 Problem: Grading a Multiple-Choice Test 

The problem is to write a program that grades multiple-choice tests. 

Suppose there are eight students and ten questions, and the answers are stored in a two- 
dimensional list. Each row records a student’s answers to the questions, as shown in the 
following illustration. 


c/Key 
/ Point 


Students’ Answers to the Questions: 


Student 0 
Student 1 
Student 2 
Student 3 
Student 4 
Student 5 
Student 6 
Student 7 


0123456789 

ABACCDEEAD 

DBABCAEEAD 

EDDACBEEAD 

CBAEDCEEAD 

ABDCCDEEAD 

BBECCDEEAD 

BBACCDEEAD 

EBECCDEEAD 


The key is stored in a one-dimensional list: 

Key to the Questions: 
0123456789 
Key DBDCCDAEAD 


The program grades the test and displays the result. To do this, the program compares each 
student’s answers with the key, counts the number of correct answers, and displays it. Listing 
11.2 shows the program. 


Listing 11.2 GradeExam.py 


1 

2 

3 

def mainO: 

# Students' answers 
answers = [ 

to the questions 


4 


- * A ' 


'C, 'C 

r»» 

LU 

LU 

, ’D], 

5 

[D- 

, ' E * 


'B', 'C 


m 

m 

, ’D], 

6 

['E' 

, 'C, 'D 


'A', 'C 

o » 

m 

m 

, ’D], 

7 

[’C 

, 'E', 'A 


'E', 'D' 

, 'C 

LU 

LU 

, 'D'], 

8 

[ .. 

, 'E', 'D 


'C, 'C 

1-^ 1 

, 'E', 'E', 

, 'D ], 

9 

[ - 

, 'E', 'E 


'C, 'C 


, 'E', 'E', 

, ], 

10 

[ - 



'C, 'C 

, 'D' 

, 'E', 'E', /. 

, 'D ], 

11 

[’£' 

, 'E', 'E 


'C, 'C 


LU 

LU 

, 'D']] 

12 

13 

# Key to 

the questions 




14 

keys = [ 

DA 'E , 

'D', 'C, 

'C , 

'D', 'A', 'E', 

A’, 'D 
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compare with key 


15 

16 # Grade all answers 

17 for i in range(len(answers)) : 

18 # Grade one student 

19 correctCount = 0 

20 for j in range(len(answers[i])): 

21 if answers[i][j] == keys[j]: 

22 correctCount += 1 

23 

24 pri ntC'Student" , i, "'s correct count is", correctCount) 

25 

26 mainO # Call the main function 


Student 

O's 

correct 

count 

i s 

7 

Student 

I's 

correct 

count 

i s 

6 

Student 

2's 

correct 

count 

i s 

5 

Student 

3's 

correct 

count 

i s 

4 

Student 

4's 

correct 

count 

i s 

8 

Student 

5's 

correct 

count 

i s 

7 

Student 

6's 

correct 

count 

i s 

7 

Student 

7's 

correct 

count 

i s 

7 



The statement in lines 3-11 creates a two-dimensional list of characters and assigns the 
reference to answers. 

The statement in line 14 creates a list of keys and assigns the reference to keys. 

Each row in the list answers stores a student’s answers, which are graded by comparing 
them with the keys in the list keys. The result is displayed immediately after a student’s 
answers are graded (lines 19-22). 


(-/Key 
/ Point 


11.5 Problem: Finding the Closest Pair 

This section presents a geometric problem for finding the closest pair of points. 

Given a set of points, the closest-pair problem is to find the two points that are nearest to each 
other. In Figure 11.2, for example, points (1, 1) and C2, 0.5) are closest to each other. 
There are several ways to solve this problem. An intuitive approach is to compute the dis¬ 
tances between all pairs of points and find the one with the minimum distance, as imple¬ 
mented in Listing 11.3. 


(- 1 . 3 ) . 

• ( 3 . 3 ) 


•( 4 , 2 ) 

( 1 , 1 ) 


• ( 2 , 0 . 5 ) 

(- 1 .- 1 ). 

• ( 4 , - 0 . 5 ) 

.( 2 ,- 1 ) 


X y 

0-1 3 

1 -1 -1 

2 1 1 

3 2 0.5 

4 2-1 

5 3 3 

6 4 2 

7 4 - 0.5 


Figure 11.2 Points can be represented in a nested list. 
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Listing 11.3 NearestPoi nts. py 

1 # Compute the distance between two points (xl, yl) and (x2, y2) 

2 def distance(xl, yl, x2, y2): 

3 return ((x2 - xl) * (x2 - xl) + (y2 - yl) * (y2 - yl)) ** 0.5 

4 

5 def nearestPointsCpoints): 

6 # pi and p2 are the indexes in the points list 

7 pi, p2 = 0, 1 # Initial two points 

8 

9 shortestDistance = distanceCpoints[pi] [0] , points[pi] [1] , 

10 points[p2] [0] , points[p2] [1] ) # Initialize shortestDistance 

11 

12 # Compute distance between every two points 

13 for i in range(len(points)): 

14 for j in range(i + 1, len(points)): 

15 d = distance(points[i] [0] , points[i] [1] , 

16 points[j] [G] , points[j] [1] ) # Find distance 

17 

18 if shortestDistance > d: 

19 pi, p2 = i, j # Update pi, p2 

20 shortestDistance = d # New shortestDistance 

21 

22 return pi, p2 


This module defines the nearestPoi nts (poi nts) function, which returns the indexes 
of the two nearest points in the two-dimensional list points. The program uses the variable 
shortestDi stance (line 9) to store the distance between the two nearest points, and the 
indexes of these two points in the points list are stored in pi and p2 (line 19). 

For each point at index i, the program computes the distance between poi nts [i] and 
poi nts [j] for all j > i (lines 15-16). Whenever a shorter distance is found, the variable 
shortestDi stance and pi and p2 are updated (lines 19-20). 

The distance between two poin ts (xl, yl) and Cx2 , y2) can be computed using the for¬ 
mula \/(x 2 — Xi)^ + Cy 2 ~ yif' (lines 2-3). 

Note that there might be more than one closest pair of points with the same minimum dis¬ 
tance. The program finds one such pair. You can modify the program to find all the closest 
pairs in Programming Exercise 11.8. 

The program in Listing 11.4 prompts the user to enter the points and then displays the 
nearest two points. 


Listing 1 1.4 Fi ndNearestPoi nts. py 

1 import NearestPoints 

2 

3 def mat n () : 

4 numberOfPoints = eval(i nputC'Enter the number of points: ")) 

5 

6 # Create a list to store points 

7 points = [] 

8 pri ntC'Enter" , numberOfPoints, "points:", end = '') 

9 for i in range(number0fPoints): 

10 poi nt = 2 * [0] 

11 point[0], point[l] = \ 

12 eval (i nputC'Enter coordinates separated by a comma; )) 

13 points.append(point) 

14 

15 # pi and p2 are the indexes in the points list 


distance between two points 

track two points 

track shortestDi stance 

for each point i 
for each point j 
distance between i and j 

update shortestDi stance 


multiple closest pairs 


import NearestPoi nts 

number of points 

2-D list 
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get nearest points 




input file 


rr^/Key 

'P / Point 


import NearestPoi nts 


16 pi, p2 = NearestPoints.nearestPoints(points) 

17 

18 # Display result 

19 printC'The closest two points are (" + 

20 str(points[pl] [0]) + ", " + str(points[pi] [1] ) + ") and (" + 

21 str(points[p2] [0]) + ", " + str(points[p2] [1] ) + ")") 

22 

23 mainO # Call the main function 


Enter the number of points: 8 
Enter coordinates separated by 
Enter coordinates separated by 
Enter coordinates separated by 
Enter coordinates separated by 
Enter coordinates separated by 
Enter coordinates separated by 
Enter coordinates separated by 
Enter coordinates separated by 
The closest two points are (1, 


p Entef| 

a comma: -1 
a comma: -1 
a comma: 1 
a comma: 2 
a comma: 2 
a comma: 3 
a comma: 4 
a comma: 4 
1) and (2 



0.5) 


The program prompts the user to enter the number of points (line 4). The points are read 
from the console and stored in a two-dimensional list named points (line 11). The program 
invokes the nearestPoi nts (poi nts) function to return the indexes of the two nearest 
points in the list (line 16). 

The program assumes that the plane has at least two points. You can easily modify the pro¬ 
gram in case the plane has zero or one point. 

Tip 

It is cumbersome to enter all points from the keyboard. You may store the input in a file, 
with a name such as FindNearestPoints.txt, and run the program using the following 
command from a command window: 

python FindNearestPoints < FindNearestPoints.txt 

11.6 GUI: Finding the Closest Pair 

This section displays the points in a canvas, finds the closest pair of points, and draws 
a line to connect these two points. 

The preceding section described a program that prompts the user to enter points and then 
finds the closest pair. This section presents a GUI program (Listing 11.5) that enables the user 
to create a point in the canvas with a left-mouse click, and it then dynamically finds the clos¬ 
est pair of points in the canvas and draws a line to connect these two points, as shown in 
Figure 11.3. 

Listing 11.5 NearestPoi ntsGUI. py 

1 import NearestPoints 

2 from tkinter import * # Import all definitions from tkinter 

3 
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4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 


RADIUS = 2 # Radius of the point 

class NearestPointsGUI: 

def _i ni t_(sel f) : 

seif.points = [] # Store self.points 

window = Tk() # Create a window 

window.titl eC'Find Nearest Points") # Set title 

self.canvas = Canvas(window, width = 400, height = 200) 
self.canvas.pack() 

self.canvas.bi nd("<Button-l>" , self.addPoint) 
window.mainloopO # Create an event loop 
def addPoint(self, event): 

if not self.isTooCloseTo0therPoints(event.x, event.y): 
self.addThisPoint(event.x, event.y) 

def addThisPoint(self, x, y): 

# Display this point 

self.canvas.create_oval(x - RADIUS, y - RADIUS, 

X + RADIUS, y + RADIUS) 

# Add this point to self.points list 
self.points.append([x, y]) 

if 1en(self.points) > 2: 

pi, p2 = NearestPoints.nearestPoints(self.points) 
self.canvas.del ete("l ine") 
self.canvas.create_line(self.points[pl] [0] , 
self.points[pi] [1] , self.points[p2] [0] , 
self.points[p2] [1] , tags = "line") 

def isTooCloseTo0therPoints(self, x, y): 
for i in range(len(self.points)): 
if NearestPoints.distance(x, y, 

sel f. poi nts [i ] [0] , sel f. poi nts [i ] [1]) <= RADIUS + 2: 

return True 

return False 

NearestPointsGUIO # Create GUI 


point radius 


points list 


create canvas 


bind event handler 


check mouse position 
add a point 


add to list 
nearest points 
draw a line 


check mouse position 
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Figure 11.3 You can add a point by clicking the left-mouse button. The two nearest points 
are connected with a line. 
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The program creates and displays a canvas (lines 12-13) and binds the left-mouse click event 
to the callback function addPoint (line 15). When the user clicks the left mouse button on the 
canvas, the addPoi nt handler is invoked (lines 19-21). The i sTooCl oseToOtherPoi nts (x, 
y) method determines whether the mouse point is too close to any of the existing points on the 
canvas (line 20). If not, the point is added to the canvas by invoking addThi sPoi nt (x, y) (line 
21 ). 

The i sTooCl oseToOtherPoi nts(x, y) method (lines 36^2) determines whether the 
point (x, y) is too close to other points in the canvas. If so, the program returns True (line 
40); otherwise, it returns Fal se (line 42). 

The addThi sPointCx, y) method (lines 23-34) displays the point on the canvas (lines 
25-26), adds the point to the points list (line 28), finds the new nearest points (line 30), and 
draws a line to connect the points (lines 32-34). 

Note that every time a new point is added, the nearestPoi nts function is invoked to find 
a pair of nearest points. This function computes the distance between every pair of two points. 
This will be very time-consuming as more points are added. For a more efficient approach, 
see Programming Exercise 11.50. 


fixed cells 
free cells 


II. 7 Problem: Sudoku 

^Key problem is to determine whether a given Sudoku solution is correct. 

Point section presents an interesting kind of problem that appears in the newspaper every day: 

the number-placement puzzle commonly known as Sudoku. This is a very challenging pro¬ 
gramming problem. To make it more accessible to novice programmers, this section presents 
a solution to a simplified version of the Sudoku problem, which is to verify whether a solution 
is correct. The complete solution for solving the Sudoku problem is presented in Supplement 

III. A. 

Sudoku is a 9 X 9 grid divided into smaller 3X3 boxes (also called regions or blocks), as 
shown in Figure 11.4a. Some cells, cdW&d fixed cells, are populated with numbers from 1 to 9. 
The objective is to fill the empty cells, also called/ree cells, with the numbers 1 to 9 so that 
every row, column, and 3X3 box contains the numbers 1 to 9, as shown in Figure 11.4b. 
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(b) Solution 


Figure 11.4 The Sudoku puzzle in (a) is solved in (b). 


For convenience, we use the value 0 to indicate a free cell, as shown in Figure 11.5a. The 
representing a grid grid can be naturally represented using a two-dimensional list, as shown in Figure 1 1.5b. 

To find a solution for the puzzle, we must replace each 0 in the grid with an appropriate 
number from 1 to 9. For the solution in Figure 11.4b, the list grid should be as shown in 
Figure 11.6. 
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(a) (b) 

Figure 11.5 A grid can be represented using a two-dimensional list. 
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Figure 11.6 A solution is stored in grid. 


Suppose a solution to a Sudoku puzzle is entered. How do you determine whether the solu¬ 
tion is correct? Here are two approaches: 

■ One way to check the solution is to verify that every row, column, and box has the 
numbers from 1 to 9. 

■ The other way is to check each cell. Each cell must contain a number from 1 to 9, 
and the cell must be unique in every row, column, and box. 

The program in Listing 11.6 prompts the user to enter a solution and reports whether it is 
valid. We use the second approach to determine whether the solution is correct. We place the 
isVal id function in the separate module in Listing 11.7 so that it can be used by other pro¬ 
grams. 

Listing 11.6 TestCheckSudokuSolution.py 

1 from CheckSudokuSolution import isValid 

2 

3 def mai n () : 

4 # Read a Sudoku solution 

5 grid = readASolutionf) 

6 

7 if isValid(grid): 

8 printC'Valid solution") 

9 el se : 

10 pri ntC'Inval id solution") 

11 


read input 
solution valid? 
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read solution 


12 # Read a Sudoku solution from the console 

13 def readASolution(): 

14 printC'Enter a Sudoku puzzle solution:") 

15 grid = [] 

16 for i in range(.): 

17 line = input().strip().split() 

18 grid.append([eval(x) for x in line]) 

19 

20 return grid 

21 

22 mainO # Call the main function 
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solution valid? 


check columns 


check rows 


check small boxes 


Listing 11.7 CheckSudokuSolution.py 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 
29 


# Check whether a solution is valid 
def isValid(grid): 

for i in range(.): 

for j in range (9): 

if grid[i][j] < 1 or grid[i][j] > 9 \ 
or not isValidAt(i, j, grid): 

return False 

return True # The fixed cells are valid 

# Check whether grid[i][j] is valid in the grid 
def isValidAt(i, j, grid): 

# Check whether grid[i][j] is valid in i's row 
for column in range(3): 

if column != j and grid[i][column] == grid[i][j]: 

return False 

# Check whether grid[i][j] is valid in j's column 
for row in range(9): 

if row != i and grid[row][j] == grid[i][j]: 

return False 

# Check whether grid[i][j] is valid in the 3-by-3 box 
for row in range((i // 3) * 3, (i // 3) * 3 + 3) : 

for col in range((j // 3) * 3, (j // 3) * 3 + 3) : 
if row != i and col != j and \ 

grid [row] [col ] == grid[i][j]: 
return False 


return True # The current value at grid[i][j] is valid 
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In Listing 11.6, the program invokes the readASolution() function (line 5) to read a 
Sudoku solution and return a two-dimensional list representing a Sudoku grid. 

The isVal idCgrid) function determines whether the values in the grid are valid. It i sVal i d function 

checks whether each value is between 1 and 9 and whether each value is valid in the grid 
(lines 7-10). 

The isValidAtCi, j, grid) function in Listing 11.7 checks whether the value at isValidAtfunction 
grid[i] [j] is valid. It checks whether grid[i] [j] appears more than once in row i (lines 
18-20), in column j (lines 13-15), and in the 3X3 hox (lines 23-27). 

How do you locate all the cells in the same box? For any grid[i][j], the starting cell of 
the 3X3 box that contains it is grid[(i // 3) * 3][(j // 3) 3] , as illustrated in 

Figure 11.7. 


grid[0][0] 


grid[6][3] ^ 

For any grid[i][j] in this 3-by-3 box, its . 
starting cell is grid[3*(i//3)][3*(j//3)] 
(i.e., grid[6][3]). For example, for 
grid[8][5], i = 8 and j = 5, 3*(i//3) = 6 
and 3*07/3) = 3. 


grid[0][6] 


' For any grid[i][j] in this 3-by-3 box, its 
starting cell is grid[3*(i//3)][3*0//3)] 

(i.e., grid[0][6]). For example, for 
grid[2][8], i = 2 and j = 8, 3*(i//3) = 0 and 
3*(j//3) = 6. 


Figure 11.7 The location of the first cell in a 3 X 3 box determines the locations of the other cells in the box. 


With this insight, you can easily identify all the cells in the box. For example, if 
grid[r] [c] is the starting cell of a 3 X 3 box, the cells in the box can be traversed in a 
nested loop as follows: 

# Get all cells in a 3-by-3 box starting at grid[r][c] 

for row in rangefr, r + 3) : 

for col in rangefc, c + 3) : 

# grid[row][col] is in the box 

It is cumbersome to enter 81 numbers from the console. When you test the program, you 
may store the input in a file, say CheckSudokuSolution.txt (see www.cs.armstrong.edu/liang/ input file 
data/CheckSudokuSolution.txt), and run the program using the following command from a com¬ 
mand window: 

python TestCheckSudokuSolution.py < CheckSudokuSolution.txt 


11.8 Case Study: Sudoku GUI 

This section shows how to create a GUI program that checks whether a given Sudoku 
solution is correct. 


^/Key 
^7 Point 


The program in the preceding section reads a Sudoku solution from the console and checks 
whether the solution is correct. This section presents a GUI program that lets the user enter 
the solution from the Entry widget and click the Validate button to check if the solution is 
correct, as shown in Figure 11.8. 
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Figure 11.8 You can enter the numbers in the Entry widget and click the Validate button 
to see if the solution is correct. 


import i sVal i d 


entries 2-D list 


create entries 


The complete program is given in Listing 11.8. 


Listing 11.8 SudokuGUI. py 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 


from tkinter import * # Import all definitions from tkinter 

import tkinter.messagebox # Import tkinter.messagebox 

from CheckSudokuSolution import isValid # Defined in Listing 11.7 

class SudokuGUI: 

def _i ni t _(sel f) : 

window = Tk() # Create a window 

window.titl eC'Check Sudoku Solution") # Set title 

frame = Framefwindow) # Hold entries 
frame.pack() 

self.cells = [] # A list of variables tied to entries 
for i in range(,): 

sel f. cel 1 s. append ([]) 
for j in range (3): 

self.cel 1s[i].append(StringVar()) 

for i in range (9): 

for j in range (9): 

EntryCframe, width = 2, justify = RIGHT, 
textvariable = self.cells[i][j]).grid( 
row = i, column = j) 
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25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 


Button (wi ndow, text = "Validate", 
command = self.validate) .pack() 

window.mainloopO # Create an event loop 

# Check if the numbers entered are a valid solution 
def validate(sel f) : 

# Get the numbers from the entries 
values = [[eval (x.getO) 

for X in self.cel 1s[i]] for i in range(.)] 

if isValid(values): 

tkinter.messagebox.show! nfoC'Check Sudoku Solution", 

"The solution is valid") 

el se : 

tkinter.messagebox.showwarni ngC'Check Sudoku Solution", 

"The solution is invalid") 


SudokuGUIO # Create GUI 


create a button 
callback handler 


validate method 


The program creates a two-dimensional list cel 1 s (lines 13-17). Each element in cel 1 s 
corresponds to a value in the entry (lines 19-23). The entries are created and placed using a 
grid manager in a frame. A button is created to be placed below the frame (lines 25-26). 
When the button is clicked, the callback handler validate is invoked (lines 31—41). The 
function obtains the values from the entries and puts them into the two-dimensional list 
values (lines 33-34), and then invokes the isValid function (defined in Listing 11.7) to 
check whether the numbers entered from the entries form a valid solution (line 36). The Tkin- 
ter’s standard dialog boxes are used to display whether a solution is valid (lines 36-41). 


11.9 Multidimensional Lists 

A two-dimensional list consists of a list of one-dimensional lists and a three-dimensional 
list consists of a list of two-dimensional lists. 


/ Point 


In the preceding sections, you used two-dimensional lists to represent a matrix or a table. 
Occasionally, you need to represent n-dimensional data. You can create n-dimensional lists 
for any integer n. For example, you can use a three-dimensional list to store exam scores for a 
class of six students with five exams, and each exam has two parts (multiple-choice and 
essay). The following syntax creates a three-dimensional list named scores. 


scores = [ 

[[11.5, 20.5], [11.0, 22.5], [15, 33.5], [13, 21.5], [15, 2.5]], 
[[4.5, 21.5], [11.0, 22.5], [15, 34.5], [12, 20.5], [14, 11.5]], 

[[6.5, 30.5], [11.4, 11.5], [11, 33.5], [11, 23.5], [10, 2.5]], 

[[6.5, 23.5], [11.4, 32.5], [13, 34.5], [11, 20.5], [16, 11.5]], 

[[8.5, 26.5], [11.4, 52.5], [13, 36.5], [13, 24.5], [16, 2.5]], 

[[11.5, 20.5], [11.4, 42.5], [13, 31.5], [12, 20.5], [16, 6.5]]] 


scores[0][1][0] refers to the multiple-choice score for the first student’s second exam, 
which is 11.0. scores [0] [1] [1] refers to the essay score for the first student’s second 
exam, which is 22.5. The following figure depicts the meaning of the values in the list. 


Which exam 

^ I r” 

scores[ i ] [ j ] [ k ] 


Which student 


Mu]tip]e-choice or essay 
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three-dimensional list 


Multidimensional Lists 

A multidimensional list is a list in which each element is another list. More specifically, a 
three-dimensional list consists of a list of two-dimensional lists, and a two-dimensional list 
consists of a list of one-dimensional lists. For example, scores [0] and scores [1] are two- 
dimensional lists, while scores [0] [0], scores [0] [1], scores [1] [0], and 
scores [1] [1] are one-dimensional lists and each contains two elements, len (scores) is 
6, len (scores [0]) is 5, and len (scores [0] [0]) is 2. 

11.9.1 Problem: Daily Temperature and Humidity 

Suppose a meteorological station records the temperature and humidity at each hour of every 
day and stores the data for the past ten days in a text file named weather.txt (see 
www.cs.armstrong.edu/liang/data/weather.txt). Each line of the file consists of four numbers that 
indicate the day, hour, temperature, and humidity. The contents of the file may look like the 
one in (a): 


1 1 

76 

.4 

0 

92 

1 2 

77 

.7 

0 

93 

10 

23 

97 

7 

0.71 

10 

24 

00 

7 

0.74 


10 

24 

98 

7 

0.74 

1 2 

77 

.7 

0 

93 

10 

23 

97 

7 

0.71 

1 1 

76 

.4 

0 

92 


(a) (b) 


Note that the lines in the file are not necessarily in order. For example, the file may appear 
as shown in (b). 

Your task is to write a program that calculates the average daily temperature and humidity 
for the 10 days. You can use input redirection to read the data from the file and store the data 
in a three-dimensional list named data. The first index of data ranges from 0 to 9 and rep¬ 
resents the 10 days; the second index ranges from 0 to 23 and represents the 24-hour periods; 
and the third index ranges from 0 to 1 and represents temperature and humidity, respectively. 
Note that the days are numbered from 1 to 10 and hours from 1 to 24 in the file. Since the list 
index starts from 0, data[0][0][0] stores the temperature in day 1 at hour 1 and 
data[9] [23] [1] stores the humidity in day 10 at hour 24. 

The program is given in Listing 11.9. 


Listing 11.9 Weather.py 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 


def mat n () : 

NUMBER_0F_DAYS = 10 
NUMBER_0F_H0URS = 24 

# Inifiaiize data 
data = [] 

for i in range(NUMBER_0F_DAYS): 
data.append([]) 

for j in range(NUMBER_0F_H0URS): 
data[i].append([]) 

data[i][j]. append(O) # Temperature value 
data[i][j]. append(O) # Humidity value 

# Read input using input redirection from a file 
for k in range(NUMBER_0F_DAYS * NUMBER_0F_H0URS): 

line = inputO .strip() .splitO 
day = eval (1 i ne [0] ) 
hour = eval(1ine [1] ) 
temperature = eval (line[2]) 
humidity = eval(1ine [3] ) 
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21 data[day - 1] [hour - 1][0] = temperature 

22 data[day - 1] [hour - 1] [1] = humidity 

23 

24 # Find the average daily temperature and humidity 

25 for i in range(NUMBER_OF_DAYS): 

26 dai1yTemperatureTotal = 0 

27 dai1yHumidityTotal = 0 

28 for j in range(NUMBER_0F_H0URS): 

29 dai1yTemperatureTotal += data[i][j] [0] 

30 dai1yHumidityTotal += data[i][j] [1] 

31 

32 # Display result 

33 printC'Day ' + str(i) + "'s average temperature is " 

34 + strCdailyTemperatureTotal / NUMBER_0F_H0URS)) 

35 printC'Day " + str(i) + "'s average humidity is ” 

36 + str(dai1yHumidityTotal / NUMBER_0F_H0URS)) 

37 

38 mainO # Call the main function 


Day 

O's 

average 

temperature 

is 77.7708 

Day 

O's 

average 

humidity is 

0.929583 

Day 

I's 

average 

temperature 

is 77.3125 

Day 

I's 

average 

humidity is 

0.929583 

Day 

9's 

average 

temperature 

is 79.3542 

Day 

9's 

average 

humidity is 

0.9125 



You can use the following command to run the program: 

python Weather.py < Weather.txt 

A three-dimensional list for storing the temperature and humidity is created in lines 6-12 
with initial values 0. The loop in lines 15-22 reads the input to the list. You can enter the input 
from the keyboard, but doing so will be awkward. For convenience, we store the data in a file 
and use input redirection to read the data from the file. The program reads one line of input as 
a string and splits it into a list (line 16) to obtain the day, hour, temperature, and humidity 
(lines 17-20). The loop in lines 25-30 adds all temperatures for each hour in a day to 
dailyTemperatureTotal and all humidity for each hour to dai 1 yHumi di tyTotal. The 
average daily temperature and humidity are displayed in lines 33-36. 

11.9.2 Problem: Guessing Birthdays 

Listing 4.3, GuessBirthday.py, is a program that guesses a birthday. The program can be sim¬ 
plified by storing the numbers in a three-dimensional list and prompting the user for the 
answers using a loop, as shown in Listing 11.10. The sample run of the program can be the 
same as shown in Listing 4.3. 

Listing 11.10 CuessBi rthdayUsingList.py 

1 def mai n () : 

2 day = 0 # Day to be determined 

3 

4 dates = [ 

5 [[ 1, 3, 5, 7], 

6 [ 9, 11, 13, 15], 

7 [17, 19, 21, 23], 


three-dimensional list 
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display a question 


8 

[25, 

27, 

29, 

31]], 

9 

[[ 2, 

3, 

6, 

7], 

10 

[10, 

11, 

14, 

15], 

11 

[18, 

19. 

22, 

23], 

12 

[26, 

27, 

30, 

31]], 

13 

[[ 4, 

5, 

6, 

7], 

14 

[12, 

13, 

14, 

15], 

15 

[20, 

21, 

22, 

23], 

16 

[28, 

29, 

30, 

31]]. 

17 

[[ 8, 

9, 

10, 

11], 

18 

[12, 

13, 

14, 

15], 

19 

[24, 

25, 

26, 

27], 

20 

[28, 

29, 

30, 

31]], 

21 

[[16, 

17, 

18, 

19], 

22 

[20, 

21, 

22, 

23], 

23 

[24, 

25, 

26, 

27], 

24 

[28, 

29, 

30, 

31]]] 


25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 ttiai 


for 1 in range(S) : 

printC'Is your birthday in Set' + str(i + 1) + "?") 
for j in rangeC ): 

for k in range(4): 

print(format(dates[i] [j][k] , "4d") _ end = ” ") 
pri nt() 

answer = eval (i nputC'Enter 0 for No and 1 for Yes: ")) 

if answer == 1: 

day += dates [i ] [i'] [0] 

printC'Your birthday is " + str(day)) 

n() # Call the main function 


A three-dimensional list dates is created in Lines 4—24. This list stores five two-dimensional 
lists of numbers, each of which is a four-by-four, two-dimensional list. 

The loop starting from line 26 displays the numbers in each two-dimensional list and 
prompts the user to answer whether the birthday is in the list (line 33). If the day is in the set, 
the first number (dates [i] [0] [0]) in the set is added to variable day (line 36). This pro¬ 
gram is identical to the one in Listing 4.3, except that this program places the five data sets 
in a list. This is a preferred way to organize data, because data can be reused and processed 
in loops. 

/Check 
L Point 

MyProgrammingLab" 


def printM(m): 

for i in range(len(m)): 

for j in range(len(m[i])): 

for k in range(len(m[j])): 

print(m[i] [j] [k], end = ’") 

print() 

m = [[[0, 0], [0, 1]], [[0, 0], [0, 1]]] 


11.7 Show the output of the following code: 
def f(m): 

for i in range(len(m)): 

for j in range(len(m[i])): 

for k in range(len(m[j])): 
m[i][j][k] += 1 
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printM(m) 
f(m) 

printM(m) 


Key Terms 


column index 362 row index 362 

multidimensional list 378 two-dimensional list 362 

nested list 362 


Chapter Summary 


1. A two-dimensional list can be used to store two-dimensional data such as a table and 
a matrix. 

2 . A two-dimensional list is a list. Each of its elements is a list. 

3 . An element in a two-dimensional list can be accessed using the following syntax: 

1istName[rowlndex][columnindex] . 

4 . You can use lists of lists to form multidimensional lists for storing multidimensional 
data. 


Test Questions 

Do test questions for this chapter online at www.c.s.armstrong.edu/liang/py/test.html. 


Programming Exercises 


MyProgrammingLab" 


Sections 11.2-11.3 

* I I. I {Sum elements column by column) Write a function that returns the sum of all the 
elements in a specified column in a matrix using the following header: 

def sumColumn(m, columnindex): 

Write a test program that reads a 3 X 4 matrix and displays the sum of each col¬ 
umn. Here is a sample run: 


Enter a 3-by-4 matrix row for row 0: 1.5 2 3 4 
Enter a 3-by-4 matrix row for row 1: 5.5 6 7 8 
Enter a 3-by-4 matrix row for row 2: 9.5 1 3 1 
Sum of the elements for column 0 is 16.5 













382 Chapter 11 Multidimensional Lists 


Sum 

of 

the 

elements 

for 

column 

1 

i s 

9.0 

Sum 

of 

the 

elements 

for 

column 

2 

i s 

13.0 

Sum 

of 

the 

elements 

for 

column 

3 

i s 

13.0 


* I 1.2 {Sum the major diagonal in a matrix) Write a function that sums all the numbers 
of the major diagonal in an n X n matrix of integers using the following header: 

def sumMajorDiagonal(m): 

The major diagonal is the diagonal that runs from the top left corner to the bottom 
right comer in the square matrix. Write a test program that reads a 4 X 4 matrix and 
displays the sum of all its elements on the major diagonal. Here is a sample mn: 


Enter a 4-by-4 matrix row for row 1 

1 2 3 4 l-i Enter j 

Enter a 4-by-4 matrix row for row 2 

5 6.5 7 8 Enter | 

Enter a 4-by-4 matrix row for row 3 

9 10 11 12 

Enter a 4-by-4 matrix row for row 4 

13 14 15 16 y-Enter| 

Sum of the elements in the major diagonal is 34.5 



{Sort students by grades) Rewrite Listing 11.2, GradeExam.py, to display the stu¬ 
dents in increasing order of the number of correct answers. 

{Compute the weekly hours for each employee) Suppose the weekly hours for all 
employees are stored in a table. Each row records an employee’s seven-day work 
hours with seven columns. For example, the following table stores the work hours 
for eight employees. Write a program that displays employees and their total hours 
in decreasing order of the total hours. 


Employee 0 
Employee 1 
Employee 2 
Employee 3 
Employee 4 
Employee 5 
Employee 6 
Employee 7 


I 1.5 {Algebra: add two matrices) Write a function to add two matrices. The header of 
the function is: 

def addMatrixCa, b) : 

In order to be added, the two matrices must have the same dimensions and the 
same or compatible types of elements. Let c be the resulting matrix. Each element 
Cjj is fly -f- bjj. Eor example, for two 3X3 matrices a and b, c is 


Su M T W Th E Sa 


2 

4 

3 

4 

5 

8 

8 

7 

3 

4 

3 

3 

4 

4 

3 

3 

4 

3 

3 

2 

2 

9 

3 

4 

7 

3 

4 

1 

3 

5 

4 

3 

6 

3 

8 

3 

4 

4 

6 

3 

4 

4 

3 

7 

4 

8 

3 

8 

4 

6 

3 

5 

9 

2 

7 

9 


*1 1.3 
**l 1.4 
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bn 
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bn\ 
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( «ii 

+ ^11 

^\2 

+ ^12 

fll3 

+ ^13 

^21 

«22 

«23 

+ U21 

bii 

bi-i 

- 

^21 

+ ^721 

0-22 

+ b22 

O22 

+ ^23 

«31 

«32 

033/ 

V^31 

b^i 

^33/ 

' 1 

\a 3 i 

+ ^31 

0-2,2 

+ ^32 

O22 

+ ^33 


Write a test program that prompts the user to enter two 3X3 matrices and dis¬ 
plays their sum. Here is a sample run: 


Enter matrixl: 123456789 [ -I Enter j 

Enter matrix2: 0 2 4 1 4.5 2.2 1.1 4.3 5.2 | center | 

The matrices are added as follows: 

I. 0 2.0 3.0 0.0 2.0 4.0 1.0 4.0 11.0 

4.0 5.0 6.0 + 1.0 4.5 2.2 = 5.0 11.5 8.2 

II. 0 8.0 11.0 1.1 4.3 5.2 8.1 12.3 14.2 



** I 1.6 (Algebra: multiply two matrices) Write a function to multiply two matrices. The 
header of the function is: 


def multiplyMatrix(a, b) 


To multiply matrix a by matrix b, the number of columns in a must be the same as 
the number of rows in b, and the two matrices must have elements of the same or 
compatible types. Let c be the result of the multiplication. Assume the column size 
of matrix a is n. Each element Cy is a, 1 X by + a-a X b 2 j + . . . + X b,y.Foi 

example, for two 3X3 matrices a and b, c is 


^flll 

Ol 2 

«13 1 

bn 

^12 

bn 

O21 

O22 

«23 

X ^21 

^22 

^23 

\fl3i 

O22 

« 33 / 

V ^31 

^32 

^33 


<^11 

C12 

tl 3 

Ql 

C22 

C22 

^31 

C32 

C33 


where Cy = an X by + aa X b2j + a ,3 X by. 

Write a test program that prompts the user to enter two 3X3 matrices and dis¬ 
plays their product. Here is a sample run: 


Enter matrixl: 123456789 [’center | 

Enter matrix2: 0 2 4 1 4.5 2.2 1.1 4.3 5.2 Enter 
The multiplication of the matrices is 
123 0 2.0 4.0 5.3 23.9 24 

456 * 1 4.5 2.2 = 11.6 56.3 58.2 

789 1.1 4.3 5.2 111.9 88.7 92.4 



*11.7 (Points nearest to each other) The program in Listing 11.3 finds the two points in a 
two-dimensional space nearest to each other. Revise the program so that it finds the 
two points in a three-dimensional space nearest to each other. Use a two-dimensional 
list to represent the points. Test the program using the following points: 

points = [[-1, 0, 3], [-1, -1, -1], [4, 1, 1], 

[2, 0.5, 9], [3.5, 2, -1], [3, 1.5, 3], [-1.5, 4, 2], 

[5.5, 4, -0.5]] 
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The formula for computing the distance between two points (xl, yl, zl) 
and Cx2, y2, z2) in a three-dimensional space is 

V(X 2 - XiC + (Jt.- y\f + (Z 2 - Zyf. 

** I 1.8 {All closest pairs of points) Revise Listing 11.4, FindNearestPoints.py, to find all 
the nearest pairs of points that have the same minimum distance. 

*** I 1.9 {Game: play a tic-tac-toe game) In a game of tic-tac-toe, two players take turns 
marking an available cell in a 3 X 3 grid with their respective tokens (either X or 
O). When one player has placed three tokens in a horizontal, vertical, or diagonal 
row on the grid, the game is over and that player has won. A draw (no winner) 
occurs when all the cells in the grid have been filled with tokens and neither player 
has achieved a win. Create a program for playing tic-tac-toe. 

The program prompts two players to alternately enter an X token and an O 
token. Whenever a token is entered, the program redisplays the board on the 
console and determines the status of the game (win, draw, or continue). Here is a 
sample run: 
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* I 1. 10 {Largest rows and columns) Write a program that randomly fills in Os and Is into 
a 4 X 4 matrix, prints the matrix, and finds the rows and columns with the most 
Is. Here is a sample run of the program: 

0011 

0011 

1101 

1010 

The largest row index: 2 
The largest column index: 2, 3 

** I 1.1 I (Game: nine heads and tails) Nine coins are placed in a 3 X 3 matrix with some 
face up and some face down. You can represent the state of the coins with the val¬ 
ues 0 (heads) and 1 (tails). Here are some examples: 


0 

0 

0 

1 

0 

1 

1 

1 

0 

1 

0 

1 

1 

0 

0 

0 

1 

0 

0 

0 

1 

1 

0 

0 

1 

1 

0 

1 

1 

1 

0 

0 

0 

1 

0 

0 

0 

0 

1 

1 

0 

0 

1 

1 

0 


Each state can also be represented using a binary number. For example, the pre¬ 
ceding matrices correspond to the numbers: 

000010000 101001100 110100001 101110100 100111110 

There are a total of 512 possibilities. So, you can use the decimal numbers 0, 1, 2, 
3, ..., and 511 to represent all states of the matrix. Write a program that prompts 
the user to enter a number between 0 and 511 and displays the corresponding 
3X3 matrix with the characters H and T. Here is a sample run: 


Enter a number between 0 and 511: 7 
H H H 
H H H 
T T T 


The user entered 7, which corresponds to 000000111. Since 0 stands for H and 1 
for T, the output is correct. 

** I 1.12 {Financial application: compute tax) Rewrite Listing 4.7, ComputeTax.py, using 
lists. For each filing status, there are six tax rates. Each rate is applied to a certain 
amount of taxable income. For example, from the taxable income of $400,000 for 
a single filer, $8,350 is taxed at 10%, (33,950 - 8,350) at 15%, (82,250 - 33,950) 
at 25%, (171,550 - 82,250) at 28%, (372,950 - 171,550) at 33%, and (400,000 - 
372,950) at 35%. The six rates are the same for all filing statuses, which can be 
represented in the following list: 

rates = [0.10, 0.15, 0.25, 0.28, 0.33, 0.35] 

The brackets for each rate for all the filing statuses can be represented in a two- 
dimensional list as follows: 

brackets = [ 

[8350, 33950, 82250, 171550, 372950], # Single filer 

[16700, 67900, 137050, 208850, 372950], # Married jointly 
[8350, 33950, 68525, 104425, 186475], # Married separately 
[11950, 45500, 117450, 190200, 372950] # Head of household 

] 
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Suppose the taxable income is $400,000 for single filers. The tax can be computed 
as follows: 

tax = brackets [0][0] * rates [0] + 

(brackets [0][1] - brackets [0][0] ) * rates [1] + 

(brackets [0][2] - brackets[ ][!]) * rates [2] + 

(brackets [0][3] - brackets [0][2] ) * rates[3] + 

(brackets [0] [:] - brackets[ ][3]) * rates[4] + 

(400000 - brackets [0][4] ) * rates [5] 

* I 1.13 {Locate the largest element) Write the following function that returns the location 
of the largest element in a two-dimensional list: 

def 1 ocateLargest(a): 

The return value is a one-dimensional list that contains two elements. These 
two elements indicate the row and column indexes of the largest element in the 
two-dimensional list. Write a test program that prompts the user to enter a two- 
dimensional list and displays the location of the largest element in the list. Here is 
a sample run: 


Enter the number of rows in the list: 3 Enter| 

Enter a row: 

23.5 35 2 10 

Enter a row: 

4.5 3 45 3.5 

Enter a row: 

35 44 5.5 11.6 

The location 

of the largest element is at (1, 2) 



** I I.I4 {Explore matrix) Write a program that prompts the user to enter the length of a 
square matrix, randomly fills in Os and Is into the matrix, prints the matrix, and 
finds the rows, columns, and major diagonal with all Os or all Is. Here is a sample 
run of the program: 



Enter the size for the matrix: 4 
0111 
0000 
0100 
1111 

An Os on row 1 

An Is on row 3 

No same numbers in a column 

No same numbers in the major diagonal 


Sections 11.4-11-9 

*I 1.15 {Geometry: same line?) Exercise 6.19 gives a function for testing whether three 
points are on the same line. Write the following function to test whether all the 
points in the poi nts list are on the same line: 

def sameLine(points): 

Write a program that prompts the user to enter five points and displays whether 
they are on the same line. Here are sample runs: 
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Enter five points: 3.4 2 6.5 11.5 2.3 2.3 5.5 5 -5 4 i^Enter 
The five points are not on the same line 


E 


Enter five points: 1122334455 
The five points are on the same line 



* I 1. 16 (Sort a list of points on y-coordinates) Write the following function to sort a list 
of points on their y-coordinates. Each point is a list of two values for x- and y- 
coordinates. 

# Returns a new list of points sorted on the y-coordinates 
def sortfpoints): 

For example, the points [[4, 2], [1, 7], [4, 5], [1, 2], [1,1], [4, 1]] will be sorted 
to [[1, 1], [4, 1], [1, 2], [4, 2], [4, 5], [1, 7]]. Write a test program that displays 
the sorted result for points [[4, 34], [1, 7.5], [4, 8.5], [1, -4.5], [1, 4.5], 
[4, 6.6]] using printCl ist). 

*** I I. I 7 (Financial tsunami) Banks lend money to each other. In tough economic times, 
if a bank goes bankrupt, it may not be able to pay back the loan. A bank’s total 
assets are its current balance plus its loans to other banks. The diagram in 
Figure 11.9 shows five banks. The banks’ current balances are 25, 125, 175, 
75, and 181 million dollars, respectively. The directed edge from node 1 to 
node 2 indicates that bank 1 lends 40 million dollars to bank 2. 


125 



Figure 11.9 Banks lend money to each other. 

If a bank’s total assets are under a certain limit, the bank is unsafe. The money 
it borrowed cannot be returned to the lender, and the lender cannot count the 
loan in its total assets. Consequently, the lender may also be unsafe if its total 
assets are under the limit. Write a program to find all unsafe banks. Your pro¬ 
gram should read the input as follows. It first reads two integers n and limit, 
where n indicates the number of banks and 1 i mi t is the minimum total assets 
for keeping a bank safe. It then reads n lines that describe the information for n 
banks with ids from 0 to n - 1. The first number in the line is the bank’s 
balance, the second number indicates the number of banks that borrowed 
money from the bank, and the rest are pairs of two numbers. Each pair 
describes a borrower. The first number in the pair is the borrower’s id and the 
second is the amount borrowed. For example, the input for the five banks in 
Figure 11.9 is as follows (note that the limit is 201): 

5 201 

25 2 1 100.5 4 320.5 
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125 2 2 40 3 85 
175 2 0 125 3 75 
75 1 0 125 
181 1 2 125 

The total assets of bank 3 are (75 + 125), which is under 201, so bank 3 is 
unsafe. After bank 3 becomes unsafe, the total assets of bank 1 fall below the limit 
(125 + 40), so bank 1 also becomes unsafe. The output of the program should be; 

Unsafe banks are 3 1 

(Hint: Use a two-dimensional list borrowers to represent loans, 
borrowers[i] [j] indicates the loan that bank i loans to bank j. Once bank j 
becomes unsafe, borrowers[i] [j] should be set to 0.) 

* I 1.18 (Shuffle rows) Write a function that shuffles the rows in a two-dimensional list 
using the following header: 

def shuffle(m): 

Write a test program that shuffles the following matrix: 

m = [[1, 2], [3, 4], [5, 6], [7, 8], [9, 10]] 

**I 1.19 (Pattern recognition: four consecutive equal numbers) Write the following 
function that tests whether a two-dimensional list has four consecutive numbers 
of the same value, either horizontally, vertically, or diagonally: 

def isConsecutiveFour(values): 

Write a test program that prompts the user to enter the number of rows and 
columns of a two-dimensional list and then the values in the list. The pro¬ 
gram displays True if the list contains four consecutive numbers with the 
same value; otherwise, it displays Fal se. Here are some examples of the 
True cases: 


0 

1 

0 

3 

1 

6 

1 

0 

1 

6 

8 

6 

0 

1 

9 

6 

2 

1 

8 

2 

9 

6 

9 

6 

1 

1 

9 

1 

1 

3 

9 

1 

4 

0 

7 

3 

3 

3 

9 

4 

0 

7 


0 

1 

0 

3 

1 

6 

1 

0 

1 

6 

8 

6 

0 

1 

5 

6 

2 

1 

8 

2 

9 

6 

5 

6 

1 

1 

9 

1 

1 

3 

6 

1 

4 

0 

7 

3 

3 

3 

3 

4 

0 

7 


0 

1 

0 

3 

1 

6 

1 

0 

1 

6 

8 

6 

0 

1 

5 

5 

2 

1 

8 

2 

9 

6 

5 

6 

1 

1 

9 

1 

1 

5 

6 

1 

4 

0 

7 

3 

5 

3 

3 

4 

0 

7 


0 

1 

0 

3 

1 

6 

1 

0 

1 

6 

8 

6 

0 

1 

5 

6 

2 

1 

6 

2 

9 

6 

5 

6 

6 

1 

9 

1 

1 

3 

6 

1 

4 

0 

7 

3 

6 

3 

3 

4 

0 

7 


*** I 1.20 (Game: Connect Four) Connect Four is a two-player board game in which the 
players alternately drop colored disks into a seven-column, six-row vertically 
suspended grid, as shown at cs.armstrong.edu/liang/ConnectFour/ConnectFour.html. 

The objective of the game is to connect four same-colored disks in a row, col¬ 
umn, or diagonal before your opponent does. The program prompts two players 
to drop a red or yellow disk alternately. Whenever a disk is dropped, the pro¬ 
gram redisplays the board on the console and determines the status of the game 
(win, draw, or continue). Here is a sample run: 
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•k** 


•kk 


k 



Drop a red disk at column (0-6): 0 


Drop a yellow disk at column (0-6): 3 


|Y| 


Drop a yellow disk at column (0-6): 6 


|R| I I 

|Y|R|Y| 

R|Y|Y|Y|Y 

RIYIRIRIR 


The yellow player won 


11.21 (Game: multiple Sudoku solutions) The complete solution for the Sudoku 
problem is given in Supplement III.A. A Sudoku problem may have multiple 
solutions. Modify Sudoku.py in Supplement III.A to display the total number 
of the solutions. Display two solutions if multiple solutions exist. 

I 1.22 (Even number of Is) Write a program that generates a 6 X 6 two-dimensional 
matrix filled with Os and Is, displays the matrix, and checks to see if every row 
and every column has an even number of Is. 

I 1.23 (Game: find the flipped cell) Suppose you are given a 6 X 6 matrix filled 
with Os and Is. All rows and all columns have the even number of Is. Let the 
user flip one cell (i.e., flip from 1 to 0 or from 0 to 1) and write a program to 
find which cell was flipped. Your program should prompt the user to enter a 
6 X 6 two-dimensional list with Os and Is and find the first row r and first 
column c where the even number of Is property is violated. The flipped cell 
is at (r, c). 
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* I 1 .24 (Check Sudoku solution) Listing 11.7 checks whether a solution is valid by check¬ 

ing whether every number is valid in the grid. Rewrite the program by checking 
whether every row, column, and box has the numbers 1 to 9. 

* I 1.25 (Markov matrix) An n X n matrix is called a positive Markov matrix if each ele¬ 

ment is positive and the sum of the elements in each column is 1. Write the fol¬ 
lowing function to check whether a matrix is a Markov matrix: 

def i sMarkovMatrix(m): 

Write a test program that prompts the user to enter a 3 X 3 matrix of numbers and 
tests whether it is a Markov matrix. Here are sample runs: 



Enter a 3-by-3 matrix row by row: 

0.15 0.875 0.375 

0.55 0.005 0.225 

0.30 0.12 0.4 

It is a Markov matrix 


Enter a 3-by-3 matrix row by row: 
0.95 -0.875 0.375 P^ 

0.65 0.005 0.225 P^ 

0.30 0.22 -0.4 p^ 

It is not a Markov matrix 


*1 1.26 (Row sorting) Implement the following function to sort the rows in a two- 
dimensional list. A new list is returned and the original list is intact. 

def sortRows(m): 

Write a test program that prompts the user to enter a 3 X 3 matrix of numbers and 
displays a new row-sorted matrix. Here is a sample run: 



Enter a 3-by-3 matrix row by row: 
0.15 0.875 0.375 P^ 

0.55 0.005 0.225 
0.30 0.12 0.4 P^ 

The row-sorted list is 
0.15 0.375 0.875 
0.005 0.225 0.55 
0.12 0.30 0.4 


* I 1.27 (Column sorting) Implement the following function to sort the columns in a two- 
dimensional list. A new list is returned and the original list is intact. 


def sortColumns(m): 
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Write a test program that prompts the user to enter a 3 X 3 matrix of numbers and 
displays a new column-sorted matrix. Here is a sample run; 




I 1.28 (Strictly identical lists) The two-dimensional lists ml and m2 are strictly identical 
if their corresponding elements are equal. Write a function that returns True if ml 
and m2 are strictly identical, using the following header: 

def equals(ml, m2): 

Write a test program that prompts the user to enter two 3X3 lists of integers and 
displays whether the two are strictly identical. Here are the sample runs: 





I 1.29 (Identical lists) The two-dimensional lists ml and m2 are identical if they have the 
same contents. Write a function that returns True if ml and m2 are identical, using 
the following header; 

def equals(ml, m2): 

Write a test program that prompts the user to enter two lists of integers and dis¬ 
plays whether the two are identical. Here are the sample runs: 


Enter ml: 51 25 22 6 1 4 24 54 6 
Enter m2: 51 22 25 6 1 4 24 54 6 
The two lists are identical 


Enter ml: 51 5 22 6 1 4 24 54 6 |^Enter| 
Enter m2: 51 22 25 6 1 4 24 54 6 [center| 
The two lists are not identical 
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* I 1.30 {Algebra: solve linear equations) Write a function that solves the following 2X2 
system of linear equations: 

floo-r + floiy = bg bffiii — hifloi ~ ^o'^io 

-1. -u -^ = y = 

fliox + any — Di floo ‘^11 <3:01010 oqo'^h < 3 oi< 3 io 

The function header is: 

def 1 inearEquationfa, b): 

The function returns None if ooo^ii ~ <3oi<3io is 0; otherwise, it returns the 
solution for x and y in a list. Write a test program that prompts the user to enter 
<3'oo> «ob tiiQ, ail, bo, and bi and displays the result. If aoo<3ii “ <3oi<3io is 0, report 

that The equation has no sol ution. Here are the sample runs: 




* I 1.31 {Geometry: intersecting point) Write a function that returns the intersecting point of 

two lines. The intersecting point of the two lines can be found by using the formula 
shown in Exercise 4.25. Assume that (xl, yl) and (x2, y2) are the two points on line 
1 and (x3, y3) and (x4, y4) are the two points on line 2. The function header is: 

def getlntersectingPoint(points): 

The points are stored in the 4X2 two-dimensional list points, with 

(points[0] [0], points[0] [1]) for (xl, yl). The function returns the inter¬ 
secting point (x, y) in a list, and None if the two lines are parallel. Write a program 
that prompts the user to enter four points and displays the intersecting point. See 
Exercise 4.25 for a sample run. 

* I 1.32 {Geometry: area of a triangle) Write a function that returns the area of a triangle 

using the following header: 

def getTriangleAreaCpoints): 

The points are stored in the 3X2 two-dimensional list points, with 

(points[0] [0], points[0] [1]) for (xl, yl). The triangle area can be com¬ 
puted using the formula in Exercise 2.14. The function returns None if the three 
points are on the same line. Write a program that prompts the user to enter three 
points and displays the area of the triangle. Here is a sample run: 



Enter xl, yl, x2, y2, x3, y3: 2.5 2 5 -1.0 4.0 2.0 ^ 
The area of the triangle is 2.25 


Enter xl, yl, x2, y2, x3, y3: 2 2 4.5 4.5 6 6 |^Enter | 
The three points are on the same line 
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* I 1.33 (Geometry: polygon subareas) A convex four-vertex polygon is divided into four 
triangles, as shown in Figure 11.10. 



Figure 11.10 A four-vertex polygon is defined by four vertices. 

Write a program that prompts the user to enter the coordinates of four vertices and 
displays the areas of the four triangles in increasing order. Here is a sample run: 




* I 1 .34 (Geometry: rightmost lowest point) In computational geometry, often you need to 
find the rightmost lowest point in a set of points. Write the following function that 
returns the rightmost lowest point in a set of points: 

# Return a list of two values for a point 
def getRightmostLowestPointfpoints): 

Write a test program that prompts the user to enter the coordinates of six points 
and displays the rightmost lowest point. Here is a sample run: 




* I 1.35 (Central city) Given a set of cities, the central point is the city that has the shortest 
total distance to all other cities. Write a program that prompts the user to enter the 
number of the cities and the locations of the cities (that is, their coordinates), and 
finds the central city. 




Enter the number of cities: 5 
Enter the coordinates of the 
cities: 2.5 5 5.1 3 1 9 5.4 54 5.5 2.1 
The central city is at (2.5, 5) 


|f Enter | 


Enter 6 points: 1.5 2.5 -3 4.5 5.6 -7 6.5 -7 8 1 10 2.5 
The rightmost lowest point is (6.5, -7) 


Enter xl, yl, x2, y2, x3, y3, x4, y4: -2.5 2 4 4 3 -2 -2 -3.5 [center 
The areas are 6.17 7.96 8.08 10.42 


** I 1.36 (Simulation using Turtle: self-avoiding random walk) A self-avoiding walk in a 
lattice is a path from one point to another that does not visit the same point twice. 
Self-avoiding walks have applications in physics, chemistry, and mathematics. 
They can be used to model chainlike entities such as solvents and polymers. Write 
a Turtle program that displays a random path that starts from the center and ends at 
a point on the boundary, as shown in Figure 11.11a, or ends at a dead-end point 
(i.e., surrounded by four points that have already been visited), as shown in Figure 
11.1 lb. Assume the size of the lattice is 16 X 16. 
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Figure 11.11 (a) A path ends at a boundary point, (b) A path ends at dead-end point. 


** I 1.37 {Simulation: self-avoiding random walk) Write a simulation program to show that 
the chance of getting dead-end paths increases as the grid size increases. Your pro¬ 
gram simulates lattices with sizes from 10 to 80. For each lattice size, simulate a 
self-avoiding random walk 10,000 times and display the probability of the dead¬ 
end paths, as shown in the following sample output: 


For 

a 

1attice 

of 

si ze 

10, 

the 

probabi1ity 

of 

dead-end 

paths 

i s 

11.6% 

For 

a 

1attice 

of 

si ze 

11, 

the 

probabi1ity 

of 

dead-end 

paths 

i s 

14.0% 

For 

a 

1attice 

of 

si ze 

80, 

the 

probabi1ity 

of 

dead-end 

paths 

i s 

99.5% 



**I 1.38 {Turtle: draw a polygon/polyline) Write the following functions that draw a 
polygon/polyline to connect all points in the list. Each element in the list is a list of 
two coordinates. 

# Draw a polyline to connect all the points in the list 
def drawPolyline(points): 

# Draw a polygon to connect all the points in the list and 

# close the polygon by connecting the first point with the last point 
def drawPolygon(points): 

# Fill a polygon by connecting all the points in the list 
def fi11 Polygon(points): 



VideoNote 

Chessboard 


**I 1.39 {Tkinter: four consecutive equal numbers) Write a GUI program for Exercise 
11.19, as shown in Eigure 11.12. Let the user enter the numbers in the text fields in 
a grid of six rows and seven columns. The user can click the Solve button to high¬ 
light a sequence of four equal numbers, if it exists. 



Figure 11.12 Clicking the Solve button highlights the four consecutive numbers in a diagonal, a row, or a column. 
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** I 1 .40 (Guess the capitals) Write a program that repeatedly prompts the user to enter a 
capital for a state. Upon receiving the user input, the program reports whether 
the answer is correct. Assume that 50 states and their capitals are stored in a two- 
dimensional list, as shown in Figure 11.13. The program prompts the user to 
answer all the states’ capitals and displays the total correct count. The user’s 
answer is not case sensitive. Implement the program using a list to represent the 
data in the following table. 


A1abama 

Montgomery 

A1aska 

Juneau 

Arizona 

Phoenix 


Figure 11.13 A two-dimensional list stores states and their capitals. 


Here is a sample run; 


What is the capital of Alabama? Montogomery Enter 

The correct answer should be Montgomery_ 

What is the capital of Alaska? Juneau 

Your answer is correct 

What is the capital of Arizona? ... 

The correct count is 35 


***l 1.41 (Tkinter: Sudoku solutions) The complete solution for the Sudoku problem is 
given in Supplement III.A. Write a GUI program that enables the user to enter a 
Sudoku puzzle and click the Solve button to display a solution, as shown in 
Figure 11.14. 



7i Sudoku ' 
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(a) (b) 


Figure 11.14 The user can enter a Sudoku puzzle in (a) and click the Solve button to display 
the solution in (b). 
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*1 1.42 (Tkinter: plot the sine function) Exercise 5.52 draws a sine function using Turtle. 

Rewrite the program to draw a sine function using Tkinter, as shown in Figure 11.15a. 



Hint 

The Unicode for tt is \u03c0. To display -2tt use turtle.write("-2\u03c0"). For 
a trigonometric function like sin(x), x is in radians. Use the following loop to add the 
points to a polygon p: 


P = [] 

for X in range(-175, 176): 

p.append([x, -50 * math.sin((x / 100.0) * 2 * 
math.pi)]) 


-2t 7 is displayed at (-100, -15), the center of the axis is at (0, 0), and 2tt is displayed at 

(100, -15). 



(a) (b) 


Figure 11.15 (a) The program plots a sine function, (b) The program plots a sine function in blue and a cosine function 

in red. 

*1 1.43 {Tkinter: plot the sine and cosine functions) Exercise 5.53 draws sine and cosine 
functions using Turtle. Rewrite the program to draw the sine and cosine functions 
using Tkinter, as shown in Figure 11.15b. 

I 1.44 {Tkinter: draw a polygon) Write a program that prompts the user to enter the 
coordinates of six points and fills the polygon that connects the points, as 
shown in Figure 11.16a. Note that you can draw a polygon using 

canvas. create_pol ygon (poi nts) , where poi nts is a two-dimensional list that 
stores the x- and y-coordinates of the points. 

* I 1 .45 {Tkinter: plot the square function) Exercise 5.54 draws a square function. Rewrite the 

program to draw the square function using Tkinter, as shown in Figure 11.16b. 



(a) (b) 

Figure 11.16 (a) A polygon is drawn from a list of values, (b) The program plots a diagram 

for function/(x) = x^. 
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* I 1 .46 (Tkinter: display a STOP sign) Write a program that displays a STOP sign, as 
shown in Figure 11.17a. The hexagon is in red and the text is in black. 


Stnp Sipn 

L 

STOP 

\ / 



(a) 


yS Find Largest Block 


0 0 1 

110 

0 10 

0 

111 

T i i| 

ifd 0 

0 

0 0 0 

1 1, 1 

10 1 

0 

0 oT 

TT'i 

110 

1 

0 0 1 

0 10 

110 

1 

0 0 0 

Too 

111 

1 

110 

0 0, 1 

0 0 1 

0 

1 oT 

0 i'^0 

ill 

1 

oil 

1 1,1 

1,1 1 

0 

111 

0 dfifirofo 

0 


Refresh | Find Largest Block 

(b) 



(c) 


Figure 11.17 (a) The program displays a STOP sign, (b-c) The program displays Os and Is 

randomly with a click of the Refresh button. 


* I 1.47 {Tkinter: largest block) Write a program that displays a 10 X 10 square matrix, as 
shown in Figure 11.17b. Each element in the matrix is a 0 or 1, randomly generated 
with a click of the Refresh button. Display each number centered in a text box. 
Allow the user to change the entry value. Click the Find Largest Block button to find 
a largest square submatrix that consists of Is. Highlight the numbers in the block, as 
shown in Figure 11.17c. 

** I 1.48 {Geometry: find the bounding rectangle) Write a program that enables the user to 
add and remove points in a two-dimensional plane dynamically, as shown in Figure 
11.18. A minimum bounding rectangle is updated as the points are added and 
removed. Assume the radius of each point is 10 pixels. 



Figure 11.18 The program enables the user to add and remove points dynamically and display the bounding rectangle. 


I 1.49 {Game: display a tic-tac-toe board) Revise Exercise 9.6 to display a new tic-tac-toe 
board with a click of the Refresh button, as shown in Eigure 11.19. 


7^ TirT^rTr... 

xxo 
000 
xoo 

Refresh | 


Figure 11.19 The program displays a new tic-tac-toe board upon clicking the Refresh button. 
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I 1.50 {Geometry: find nearest points) When a new point is added to the plane, Listing 
11.5 finds the pair of two nearest points by examining the distance between every 
pair of two points. This approach is correct, but not efficient. A more efficient algo¬ 
rithm can be described as follows: 

Let d be the current shortest distance between two 
nearest points pi and p2 
Let p be the new point added to the plane 
For each existing point t: 
if distancefp, t) < d: 
d = distancefp, t) 
pi, p2 = p, t 

Rewrite Listing 11.5 using this new approach. 

** I 1.51 {Sort students) Write a program that prompts the user to enter the students’ 
names and their scores on one line, and prints student names in increasing order 
of their scores. (Hint: Create a list. Each element in the list is a sublist with two 
elements: score and name. Apply the sort method to sort the list. This will sort 
the list on scores.) 


Enter 

students’ names and scores: John 34 Jim 45 Peter 59 

Tim 

4 5 -J Enter I 

John 

34 

Jim 

45 

Ti m 

45 

Peter 

59 



** I 1.52 {Latin square) A Latin square is an n by n list filled with n different Latin letters, 
each occurring exactly once in each row and once in each column. Write a pro¬ 
gram that prompts the user to enter the number n and the list of characters, as 
shown in the sample output and check if the input list is a Latin square. The char¬ 
acters are the first n characters starting from A. 


Enter number n: 4 Enter | 

Enter 4 

rows of letters separated by spaces: 

A B C D 

1 .-1 Enter j 

BADE 

l^^nteTj 

C D B A 


D C A B 


The input list is a Latin square 



Enter number n: 3 [ -I Enter | 

Enter 3 rows of letters separated by spaces: 

A F D I ^ Enter | 

Wrong input. The letters must be from A to C. 
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12 

Inheritance 
AND Polymorphism 

objectives 

■ To define a subclass from a superclass through inheritance (§12.2). 

■ To override methods in a subclass (§12.3). 

■ To explore the object class and its methods (§12.4). 

■ To understand polymorphism and dynamic binding (§12.5). 

■ To determine whether an object is an instance of a class by using the 
isinstance function (§12.6). 

■ To design a GUI class for displaying a reusable clock (§12.7). 

■ To discover relationships among classes (§12.8). 

■ To design classes by using composition and inheritance relationships 
(§§12.9-12.11). 
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12.1 Introduction 

Object-oriented programming (OOP) allows you to define new classes from existing 
classes. This is called inheritance. 

inheritance 

As discussed earlier in the hook, the procedural paradigm focuses on designing functions and 
the object-oriented paradigm couples data and methods together into objects. Software design 
using the object-oriented paradigm focuses on objects and operations on objects. The object- 
oriented approach combines the power of the procedural paradigm with an added dimension 
that integrates data with operations into objects. 

Inheritance extends the power of the object-oriented paradigm by adding an important and 
powerful feature for reusing software. Suppose that you want to define classes to model cir¬ 
cles, rectangles, and triangles. These classes have many common features. What is the best 
way to design these classes to avoid redundancy and make the system easy to comprehend 
and maintain? The answer is to use inheritance. 


12.2 Superclasses and Subclasses 

Inheritance enables you to define a general class (a superclass) and later extend it to 
more specialized classes (subclasses). 

why inheritance? 

D 

You use a class to model objects of the same type. Different classes may have some common 
properties and behaviors that you can generalize in a class, which can then be shared by other 
classes. Inheritance enables you to define a general class and later extend it to define more spe¬ 
cialized classes. The specialized classes inherit the properties and methods from the general class. 

Consider geometric objects. Suppose you want to design classes to model geometric 

VideoNote 

Inheritance 
and polymorphism 

objects such as circles and rectangles. Geometric objects have many common properties and 
behaviors; for example, they can be drawn in a certain color, and they can be either filled or 
unfilled. Thus, a general class GeometricObject can be used to model all geometric 
objects. This class contains the properties color and filled and their appropriate get and 
set methods. Assume that this class also contains the dateCreated property and the 

getDateCreatedO and _str _() methods. The _str _() method returns a string 

description for the object. 

Because a circle is a special type of geometric object, it shares common properties and 
methods with other geometric objects. For this reason, it makes sense to define a Ci rcl e 
class that extends the GeometricObject class. Similarly, you can define Rectangle as a 
subclass of GeometricObject. Figure 12.1 shows the relationship among these classes. A 

triangular arrow 

triangular arrow pointing to the superclass is used to denote the inheritance relationship 
between the two classes involved. 

subclass 

superclass 

Note 

In OOP terminology, a class Cl extended from another class C2 is called a derived class, 
child class, or subclass, and C2 is called a base class, parent class, or superclass. For 
consistency, this book uses the terms “subclass” and “superclass.” 

A subclass inherits accessible data fields and methods from its superclass, but it can also 
have other data fields and methods. In our example: 

■ The Circle class inherits all accessible data fields and methods from the 
GeometricObject class. In addition, it has a new data field, radius, and its asso¬ 
ciated get and set methods. It also contains the getAreaO, getPerimeter (), 
and getOiameterC) methods for returning the area, perimeter, and diameter of a 
circle. The printCircleC) method is defined to print the information about the 
circle. 
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GeometricObject 


-color: str 
-filled: bool 


CeometricObject(color: str, filled: 
bool) 

getColorC): str 
setColorCcolor: str): None 
isFilledC): bool 
setFi 11 ed(fi 11 ed: bool): None 

_str_() : str 

- 




The color of the object (default : green). 

Indicates whether the object is filled with a color (default: True). 

Creates a Ceometri cObject with the specified color and filled 
values. 

Returns the color. 

Sets a new color. 

Returns the f i 11 ed property. 

Sets a new f i lied property. 

Returns a string representation of this object. 


Circle 

Rectangle 

-radius: float 

-width: float 
-height: float 

Ci rcle(radius: float, color: str, 
filled: bool) 

Rectangle(width: float, height: float, color: 

getRadiusC): float 

string, filled: bool) 

setRadius(radius: float): None 

getWidthO: float 

getAreaO : float 

setWidth(width: float): None 

getPerimeterO: float 

getHeightO: float 

getDiameterO: float 

setHeight(height: float): None 

pri ntCi rcl eO : None 

getAreaO: float 
getPerimeterO: float 


Figure 12.1 The GeometricObject class is the superclass for Circle and Rectangle. 


■ The Rectangle class inherits all accessible data fields and methods from the 
GeometricObject class. In addition, it has the data fields width and height and 
the associated get and set methods. It also contains the getAreaO and 
getPerimeterO methods for returning the area and perimeter of the rectangle. 

The GeometricObject, Circle, and Rectangle classes are shown in Listings 12.1, 
12.2, and 12.3. 


Listing 12.1 Ceometri cObject.py 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 


class GeometricObject: 

def _init_(self, color = ’green' , filled = True): 

self._color = color 

self._filled = filled 

def getColor(self) : 

return self._color 

def setColor(self, color): 
self._color = color 


GeometricObject class 

initializer 

data fields 


getColor 


setColor 


def isFilled(self): 

return self._filled 


i sFi lied 
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setFi lied 


str 


import Ceomet ri cOb j ect 

extend Ceomet ri cObject 
initializer 

superclass initializer 


14 

15 def setFi11ed(self, filled): 

16 self._filled = filled 

17 

18 def str (self): 

19 return "color: " + self._color + \ 

20 " and filled: " + str(self._filled) 


Listing 12.2 Ci rcleFromCeometricObject.py 

1 from CeometricObject import GeometricObject 

2 import math # math.pi is used in the class 

3 

4 class Circle(GeometricObject): 

5 def _ _init_(self, radius): 

superO ._i ni t_() 

self._radius = radius 


6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 


def getRadius(self): 

return self._radius 

def setRadius(self, radius); 
self._radius = radius 

def getArea(self): 

return self._radius 


self._radius * math.pi 


def getOiameter(self): 

return 2 * self._radius 

def getPerimeter(self): 

return 2 * self. radius 


math.pi 


def pri ntCi rcl e(sel f) : 

print(self._str_() + " radius: '' + str(self.. 


_radius)) 


The Circle class is derived from the GeometricObject class (Listing 12.1), based on 
the following syntax: 


subclass superclass 

\ / 

class Circle(CeometricObject): 


This tells Python that the Circle class inherits the CeometricObject class, thus inher¬ 
iting the methods getColor, setColor, isFilled, setFi lied, and _ str _ . The 

printCircle method invokes the _ _str _() method defined to obtain properties defined 

in the superclass (line 25). 

superO ._init _() calls the superclass’s _ init_ method (line 6). This is neces¬ 

sary to create data fields defined in the superclass. 

Note 

Alternatively, you can invoke the superclass’s _ init_ method by using: 

Ceomet ri cObject._i ni t_(sel f) 
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This is an old style of syntax that is still supported in Python, but it isn't the preferred 
style, super () refers to the superclass. Using super () lets you avoid referring the 
superclass explicitly. When invoking a method using super (), don't pass sel f in the 
argument. For example, you should use 

superO ._ 1 ni t_() 

rather than 

superO ._ 1 ni t_(sei f) 

The Rectangle class, derived from the GeometricObject class (Listing 12.1), is 
defined similarly in Listing 12.3. 

subclass superclass 

\ / 

class Rectangle(CeometricObject): 


Listing 12.3 RectangleFromCeometricObject.py 

1 from GeometricObject import GeometricObject 

2 

3 class Rectangle(GeometricObject): 


4 

5 

def 

_init_(self, width = 1, height = 1): 

superO ■_i nit_() 

6 


self._width = width 

7 

8 

9 


self._height = height 

def 

getWidth(self) : 

10 


return self._width 

11 



12 

def 

setWidth(self, width): 

13 


self._width = width 

14 



15 

def 

getHeight(self): 

16 


return self._height 

17 



18 

def 

setHeight(self, height): 

19 


self._height = self._height 

20 



21 

def 

getArea(self): 

22 


return self._width * self._height 

23 



24 

def 

getPerimeter(self) : 

25 


return 2 * (self._width + self._height) 


extend superclass 
initializer 

superclass initializer 


methods 


The code in Listing 12.4 creates Circle and Rectangle objects and invokes the 

getAreaO and getPerimeter C) methods on these objects. The _str _() method is 

inherited from the GeometricObject class and is invoked from a Circle object (line 5) 
and a Rectangl e object (line 11). 


Listing 12.4 TestCi rcleRectangle.py 

1 from CircleFromCeometricObject import Circle 

2 from RectangleFromCeometricObject import Rectangle 

3 
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4 

def mainO : 

Cl rcl e object 

5 

circle = Circle(1.5) 

invoke_str_ 

6 

printC'A circle", circle) 


7 

printC'The radius is", circle.getRadius() ) 


8 

printC'The area is", ci rcle.getAreaO) 


9 

printC'The diameter is", ci rcle.getDiameterO) 


10 


Rectangle object 

11 

rectangle = Rectangl e(2, 4) 

invoke_str_ 

12 

print("\nA rectangle", rectangle) 


13 

printC'The area is", rectangle.getAreaO) 


14 

printC'The perimeter is", rectangle.getPerimeterO) 


15 



16 

mainO # Call the main function 


A circle color: green and filled: True 
The radius is 1.5 
The area is 7.06858347058 
The diameter is 3.0 

A rectangle color: green and filled: True 

The area is 8 

The perimeter is 12 


Line 6 invokes the print function to print a circle. Recall from Section 8.5, this is the 
same as 

printC'A circle", circle._str_()) 

The_ str _() method is not defined in the Circle class, but is defined in the 

GeometricObject class. Since Circle is a subclass of CeometricObject,_str_() 

can be invoked from a Ci rcl e object. 

The _st r _() method displays the col or and f i 11 ed properties of a Geomet r i cOb j ect 

(lines 18-20 in Listing 12.1). The default color for a GeometricObject object is green and 
filled is True (line 2 Listing 12.1). Since a Circle inherits from CeometricObject, the 
default col or for a Ci rcl e object is green and the default value for f i 11 ed is True. 

The following points regarding inheritance are worthwhile to note: 

more in subclass 

is-a relationships 
nonextensible is-a 


no blind extension 


multiple inheritance 


1 m ti a n zer 
methods 


■ Contrary to the conventional interpretation, a subclass is not a subset of its superclass. 
In fact, a subclass usually contains more information and methods than its superclass. 

■ Inheritance models the is-a relationships, but not all is-a relationships should be modeled 
using inheritance. For example, a square is a rectangle, but you should not extend a 
Square class from a Rectangle class, because the width and height properties are 
not appropriate for a square. Instead, you should define a Square class to extend the 
GeometricObject class and define the side property for the side of a square. 

■ Do not blindly extend a class just for the sake of reusing methods. For example, it 
makes no sense for a Tree class to extend a Person class, even though they share 
common properties such as height and weight. A subclass and its superclass must 
have the is-a relationship. 

■ Python allows you to derive a subclass from several classes. This capability is known 
as multiple inheritance. To define a class derived from multiple classes, use the 
following syntax: 

class Subclass(SuperClassl, SuperClass2, ...): 
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12.1 How do you define a class that extends a superclass? What is super () ? How do you 
invoke the superclass’s initializer? 

12.2 What problem arises in running the following program? How do you fix it? 

class A: 

def init (self, 1=0): 

self.! = i 

class B(A); 

def init (self, j =0): 

self.j = j 

def mai n() : 
b = B() 
print(b.i) 
print(b.j) 

mainO # Call the main function 

12.3 True or false? A subclass is a subset of a superclass. 

12.4 Does Python support multiple inheritance? How do you define a class that extends 
multiple classes? 

12.3 Overriding Methods 

To override a method, the method must be defined in the subclass using the same 
header as in its superclass. 

A subclass inherits methods from a superclass. Sometimes it is necessary for the subclass to 
modify the implementation of a method defined in the superclass. This is referred to as 
method overriding. 

The _str_ method in the CeometricObject class returns the string describing a geo¬ 
metric object. This method can be overridden to return the string describing a circle. To over¬ 
ride it, add the following new method in Listing 12.2, CircleFromGeometricObject.py: 

1 class Clrcle(GeometricObject): 

2 # Other methods are omitted 

3 

4 # Override the_str_method defined In CeometricObject 

5 def _str_(self): 

6 return super()._str_() + " radius: " + str(radlus) 

The _str_() method is defined in the CeometricObject class and modified in the 

Circle class. Both methods can be used in the Circle class. To invoke the _str_ 

method defined in the CeometricObject class from the Circle class, use 

superO ._str_() (line 6). 

Similarly, you can override the _ _str_ method in the Rectangl e class as follows: 
def _str_(sel f) : 

return super() ._str_() -i- " width: " + \ 

str(self._width) + " height: " + str(self._height) 

For the rest of the book, we assume that the_ str_() method in CeometricObject 

class has been overridden in the Ci rcl e and Rectangl e classes. 


i^eck 
w Point 

MyProgrammingLab” 


^/Key 
7 Point 


override 


str_in superelass 
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Note 

Recall that you can define a private method in Python by adding two underscores in 
front of a method name (see Chapter 7). A private method cannot be overridden. If a 
method defined in a subclass is private in its superclass, the two methods are completely 
unrelated, even though they have the same name. 

12.5 True or false? 

(a) You can override a nonprivate method defined in a superclass. 

MyProgrammingLab' 

(b) You can override a private method defined in a superclass. 

(c) You can override the initializer defined in a superclass. 

(d) When constructing an object from a subclass, its superclass’s initializer is auto¬ 
matically invoked. 

12.6 Show the printout of the following program: 

class A: 

def _ init_(seif, i = 0) : 

self.i = i 

def ml(sel f): 
self.i += 1 




class B(A): 

def _ init_(self, j =0): 

superO ._init_ (3) 

self.j = j 

def ml(self): 
self.i += 1 

def mai n(): 
b = B() 
b.mlO 
print(b.i) 
print(b.j) 

mainO # Call the main function 




12.4 The object Class 

Every class in Python is descended from the object class. 

The object class is defined in the Python library. If no inheritance is specified when a class is 
defined, its superclass is object by default. For example, the following two class definitions 
are the same: 


Equivalent 


class ClassName: 


class ClassName(object) : 


The Circle class is derived from GeometricObject and the Rectangle class is derived 
from GeometricObject. The GeometricObject class is actually derived from object. It 
is important to be familiar with the methods provided by the object class so that you can use 
them in your classes. All methods defined in the object class are special methods with two 

leading underscores and two trailing underscores. We discuss four methods— __new_(), 

_init (), str (), and _eq (other) —in this section. 
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The _new_() method is automatically invoked when an object is constructed. This 

method then invokes the _init_C) method to initialize the object. Normally you 

should only override the_ init_C) method to initialize the data fields defined in the 

new class. 

The _str_() method returns a string description for the object. By default, it returns a 

string consisting of a class name of which the object is an instance and the object’s memory 
address in hexadecimal format. For example, consider the following code for the Loan class, 
which was defined in Listing 7.8: 

loan = Loan(l, 1, 1, "Smith") 

print(loan) # Same as printfloan._str_()) 

The code displays something like <Loan. Loan object at 0x01B99C10>. This mes¬ 
sage is not very helpful or informative. Usually you should override the _str_() method 

so that it returns an informative description for the object. For example, the _str_() 

method in the object class was overridden in the CeometricObject class in lines 18-20 in 
Listing 12.1 as follows: 

def _str_(sei f) : 

return "color: " + self._color + \ 

" and filled: + strfself._filled) 

The _eq (other) method returns True if two objects are the same. So, 

X. eq (x) is True, but x. eq (y) returns Fal se, because x and y are two different 

objects even though they may have the same contents. Recall that x._eq_(y) is same as 

X == y (see Section 8.5). 

You can override this method to return True if two objects have the same contents. The 

_eq__ method is overridden in many Python built-in classes such as int, float, bool, 

stri ng, and 1 i st to return True if two objects have the same contents. 

12.7 True or false? 

(a) Every object is an instance of the object class. 

(b) If a class does not extend a superclass explicitly, it extends object by default. 

12.8 Show the printout of the following code: 

class A: 

def _init_(self, i = 0) : 

self.i = i 

def ml(self): 
self.i += 1 

def _str_(self) : 

return str(self.i) 

X = A(8) 
print(x) 

12.9 Show the printout of the following program: 

class A: 

def _ _new (sel f) : 

print(''A's_ new_() invoked") 

def _i ni t_(sel f) : 

printC'A's _init_() invoked") 


_new_() 

_init_() 

__str__0 


_eq_(other) 


/Check 
1 Point 

MyProgrammingLab" 
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class B(A): 

def _ _new (sel f) ; 

printC'B's_ new_() invoked") 

def _i ni t_(sel f) : 

printC'B's _init_() invoked") 

def mai n(): 
b = B() 
a = A() 

mainO # Call the main function 

12.10 Show the printout of the following program: 

class A: 

def _ _new (sel f) : 

sel f._i ni t_(sel f) 

printC'A's _new_() invoked") 

def _i ni t_(sel f) : 

printC'A's_ init_() invoked") 

class B(A): 

def _ _new (sel f) : 

sel f._i ni t_(sel f) 

printC'B's _new_() invoked") 

def _i ni t_(sel f) : 

printC'B's_ init_() invoked") 

def mai n(): 
b = B() 
a = A() 

mainO # Call the main function 


12.1 I Show the printout of the following program: 

class A: 

def _i ni t_(sel f) : 

printC'A's init () invoked") 

class B(A): 

def _i ni t_(sel f) : 

printC'B's init () invoked") 

def mai n(): 
b = B() 
a = A() 

mainO # Call the main function 

12.12 Show the printout of the following program: 

class A: 

def _ _init_(self, i): 

self.i = i 
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def _str_(sel f) : 

return "A" 

class B(A): 

def _init_(self, 1, j): 

superO ._ 1 nit_(i) 

self.j = j 

def mai n() : 

b = BCl, 2) 
a = ACD 
print(a) 
print(b) 

mainO # Call the main function 

12.13 Show the printout of the following program: 

class A: 

def _init_(self, i): 

self.i = i 

def _str_(self) : 

return "A" 

def _eq_(self, other): 

return self.i == other.i 

def main(): 

X = A(l) 
y = A(l) 
print(x == y) 

mainO # Call the main function 


12.5 Polymorphism and Dynamic Binding 

Polymorphism means that an object of a subclass can be passed to a parameter of a 
superclass type. A method may be implemented in several classes along the 
inheritance chain. Python decides which method is invoked at runtime. This is known 
as dynamic binding. 

The three pillars of ohject-oriented programming are encapsulation, inheritance, and 
polymorphism. You have already learned the first two. This section introduces polymorphism. 

The inheritance relationship enables a subclass to inherit features from its superclass with 
additional new features. A subclass is a specialization of its superclass; every instance of a 
subclass is also an instance of its superclass, but not vice versa. For example, every circle is a 
geometric object, but not every geometric object is a circle. Therefore, you can always pass an 
instance of a subclass to a parameter of its superclass type. Consider the code in Listing 12.5. 


^ ) Point 

polymorphism 



VideoNote 

Dynamic binding 


Listing 12.5 Polymorphi smDemo. py 

1 from CircleFromCeometricObject import Circle 

2 from RectangleFromCeometricObject import Rectangle 

3 

4 def mai n () : 

5 # Display circle and rectangle properties 
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6 

c = Circle (4) 


7 

r = RectangleCl, 3) 

polymorphic call 

8 

displayObject(c) 

polymorphic call 

9 

displayObject(r) 


10 

printC'Are the circle and rectangle the same size?" 

polymorphic call 

11 

isSameAreafc, r)) 


12 



13 

# Display geometric object properties 


14 

def displayObject(g) : 


15 

print(g._str_()) 


16 



17 

# Compare the areas of two geometric objects 


18 

def isSameAreaCgl, g2) : 


19 

return gl.getAreaf) == g2.getArea() 


20 



21 

mainO # Call the main function 



color: green and filled: True radius: 4 

color: green and filled: True width: 1 height: 3 

Are the circle and rectangle the same size? False 


The di spl ayObject method (line 14) takes a parameter of the CeometricObject type. 
You can invoke displayObject by passing any instance of CeometricObject (for exam¬ 
ple, Ci rcl eC4) and Rectangl efl, 3) in lines 8-9). An object of a subclass can be used 
what is polymorphism? wherever its superclass object is used. This is commonly known as polymorphism (from a 

Greek word meaning “many forms”). 

As seen in this example, c is an object of the Circle class. Circle is a subclass of 

CeometricObject. The _ str _() method is defined in both classes. So, which 

_str_C) method is invoked by g in the displayObject method (line 15)? The 

_str__0 method invoked by g is determined using dynamic binding. 
dynamic binding Dynamic binding works as follows: Suppose an object is an instance of classes Ci, C 2 , ..., 

Cn-i, and Cn, where Ci is a subclass of C2, C2 is a subclass of C3, ..., and Cn-i is a subclass of 
Cp, as shown in Figure 12.2. That is, Cp is the most general class, and Ci is the most specific 
class. In Python, Cp is the object class. If o invokes a method p. Python searches the imple¬ 
mentation for the method p in Ci, C2, ..., Cp_i, and Cp, in this order, until it is found. Once an 
implementation is found, the search stops and the first-found implementation is invoked. 

Listing 12.6 provides an example that demonstrates dynamic binding. 


Cn \<\— C„-1 | <^ 


object 


A - C2 1 ^ - Cl I 

If o is an instance of Ci, o is also an 
instance of C2, C3, ..., Cp-i, and Cp. 


Figure 12.2 The method to be invoked is dynamically bound at runtime. 


Listing 12.6 DynamicBindingDemo.py 

1 class Student: 

override_str _() 2 def _ Str _(self): 

3 return "Student" 









12.6 The isinstance Function 411 


4 

5 def printStudent(self): 

6 printCself. str ()) 

7 

8 class GraduateStudent(Student): 

9 def _ _Str _(self): override 

10 return "Graduate Student" 

11 

12 a = StudentO 

13 b = GraduateStudentO 

14 a. pri ntStudentO 

15 b. pri ntStudentO 


Student 

Graduate Student 



Since a is an instance of Student, the printStudent method in the Student class is 

invoked for a.printStudentC) (line 14), which invokes the Student class’s_ str_() 

method to return Student. 

No printStudent method is defined in GraduateStudent. However, since it is defined 

in the Student class and GraduateStudent is a subclass of Student, the printStudent 

method in the Student class is invoked for b. pri ntStudentO (line 15). The 

printStudent method invokes GraduateStudent’s_str_O method to display 

Graduate Student, since the object b that invokes printStudent is GraduateStudent 

(lines 6 and 10). 


) Point 

Suppose you want to modify the di spl ayObject function in Listing 12.5 to perform the fol¬ 
lowing tasks: 

■ Display the area and perimeter of a GeometricObject instance. 

■ Display the diameter if the instance is a Circle, and the width and height if the 
instance is a Rectangle. 

How can this be done? You might be tempted to write the function as: 

def displayObject(g): 

printC'Area is", g.getAreaO) 
pri ntC’Perimeter is", g.getPerimeterO) 
pri ntC'Diameter is", g.getDiameterO) 
printC'Width is", g.getWidthO) 
printC'Height is", g.getHeightO) 

This won’t work, however, because not all GeometricObject instances have the 

getDiameterC), getWidthC), or getHeightC) methods. For example, invoking 
display(Circle(5)) will cause a runtime error because Circle does not have the 
getWidthC) and getHeightC) methods, and invoking display(Rectang1e(2, 3)) 

will cause a runtime error because Rectangle does not have the getDiameterC) method. 


12.6 The isinstance Function 

The i si nstance/Mnction can be used to determine whether an object is an instance 
of a class. 


.str__0 
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You can fix this problem by using Python’s built-in isinstance function. This function 
determines whether an object is an instance of a class by using the following syntax; 

isinstance(object, ClassName) 

For example, isinstanceC'abc", str) returns True because "abc" is an instance of 
the str class, but isinstanceC12, str) returns False because 12 is not an instance of 
the str class. 

Using the isinstance function, you can implement the displayObject function as 
shown in Listing 12.7. 


Listing 12.7 IsinstanceDemo.py 



1 

from CircleFromCeometricObject import Circle 


2 

■2 

from RectangleFromCeometricObject import Rectangl 


J 

4 

def mainO : 


5 

# Display circle and rectangle properties 


6 

c = Circl eC4) 


7 

r = RectangleCl, 3) 


8 

pri nt("Ci rcle... ") 

polymorphic call 

9 

displayObject(c) 


10 

printC'Rectangle. . .") 

polymorphic call 

11 

displayObject(r) 


12 



13 

# Display geometric object properties 


14 

def displayObject(g); 


15 

printC'Area is", g.getAreaO) 


16 

print( 'Perimeter is", g.getPerimeterO) 


17 


isinstance? 

18 

if isinstance(g, Circle): 


19 

pri ntC'Diameter is", g.getDiameterO) 

isinstance? 

20 

elif isinstance(g, Rectangle): 


21 

printC'Width is' , g.getWidthO) 


22 

printC'Height is", g.getHeight()) 


23 



24 

mainO # Call the main function 



Ci rcle. . . 

Area is 50.26548245743669 
Perimeter is 25.132741228718345 
Diameter is 8 
Rectangle... 

Area is 3 
Perimeter is 8 
Width is 1 
Height is 3 


Invoking di sp1 ayOb j ect (c) passes c to g (line 9). g is now an instance of Ci rcl e (line 
18). The program displays the circle’s diameter (line 19). 

Invoking displayObject(r) passes r to g (line 11). g is now an instance of Rectangle 
(line 20). The program displays the rectangle’s width and height (lines 21-22). 




KJ M 


12.6 The isinstance Function 413 


. 14 Explain encapsulation, inheritance, and polymorphism. 
. 15 Show the output of the following code: 


class Person: 


class Person: 

def getInfoCself): 


def _getlnfo(self) : 

return 'Person" 


return ’Person" 

def printPerson(self) : 


def printPerson(self) : 

pri ntfself .getInfoO) 


pri nt(sel f._getlnfoO) 

class Student(Person): 


class Student(Person): 

def getInfoCself): 


def _getlnfo(self) : 

return "Student" 


return "Student" 

PersonO .printPersonf) 


PersonO .printPersonO 

StudentO . pri ntPersonf) 


StudentO .printPersonO 


(a) (b) 


iraeck 
W Point 

MyProgrammingLab" 


12.16 Suppose that Fruit, Apple, Orange, ColdenDelicious, and McIntosh are 

defined in the inheritance hierarchy as follows: 


Frui t 


Appl e 

ColdenDelicious I McIntosh 


Orange 


Assume that the following statements are given: 

goldenDelicious = GoldenDeliciousO 
orange = OrangeO 

Answer the following questions: 

(a) Is goldenDelicious an instance of Fruit? 

(b) Is goldenDel icious an instance of Orange? 

(c) Is goldenDelicious an instance of Apple? 

(d) Is goldenDel icious an instance of GoldenDel icious? 

(e) Is goldenDel icious an instance of McIntosh? 

(f) Is orange an instance of Orange? 

(g) Is orange an instance of Fruit? 
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(h) Is orange an instance of Appl e? 

(i) Suppose the method makeAppleCider is defined in the Apple class. Can 
go! denDe! Icious invoke this method? Can orange invoke this method? 

(j) Suppose the method makeOrangeJuice is defined in the Orange class. Can 
orange invoke this method? Can go1denDe1 icious invoke this method? 

12.7 Case Study: A Reusable Clock 

This section designs a GUI class for displaying a clock. 

Suppose you want to display a clock on a canvas and later reuse the clock in other programs. 
You need to define a clock class to make the clock reusable. Furthermore, in order to display 
the clock graphically, you should define it as a widget. Your best option is to define a clock 
class that extends Canvas so that a clock object can be used in the same way as a Canvas 
object. 

The contract of the class is shown in Figure 12.3. 


^/Key 
Y ? Point 


tkinter.Canvas 


T 


StillClock 


-hour: int 
-minute: int 
-second: int 


Still ClockCcontainet) 
setCurrentTimeO : None 


The get and set methods for these 
data fields are provided in the class, but 
omitted from the UML diagram for brevity. I 


The hour in the clock. 

The minute in the clock. 

The second in the clock. 

Constructs a default clock for the current time, 
placed inside a container. 

Sets hour, minute, and second to current time. 


Figure 12.3 StillClock displays an analog clock. 


Listing 12.8 is a test program that uses the Sti 11 Cl ock class to display an analog clock. 
The program enables the user to enter a new hour, minute, and second from the Entry fields, 
as shown in Figure 12.4a. 


Listing 12.8 DisplayClock.py 



1 

from tki nter import •• # Import all definitions from tki nter 

import StillClock 

2 

D 

from StillClock import StillClock 



5 

4 

class DisplayClock: 



5 

def _i ni t_(sel f) : 



6 

window = Tk() # Create a window 



7 

8 

window. titleC'Change Clock Time") 

# Set title 

create a clock 

9 

10 

self.clock = Sti11 Clock(window) # 
self .clock.packO 

Create a clock 


11 




12 

frame = Frame(window) 



13 

frame.pack() 
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14 Label(frame, text = "Hour: ") .pack(side = LEFT) 

15 self.hour = IntVarO 

16 self. hour. set (self .clock. getHourO) 

17 Entry(frame, textvariable = self.hour, 

18 width = 2).pack(side = LEFT) 

19 Label(frame, text = "Minute: ").pack(side = LEFT) 

20 self.minute = IntVarO 

21 self.mi nute. set(self. clock.getMi nuteO) 

22 Entry(frame, textvariable = self.minute, 

23 width = 2).pack(side = LEFT) 

24 Label(frame, text = "Second: ").pack(side = LEFT) 

25 self.second = IntVarO 

26 sel f. second. set (sel f. cl ock. getMi nuteO) 

27 Entry(frame, textvariable = self.second, 

28 width = 2).pack(side = LEFT) 

29 Button(frame, text = 'Set New Time’, 

30 command = self.setNewTime).pack(side = LEFT) 

31 

32 window.mainloopO # Create an event loop 

33 

34 def setNewTime(self): 

35 self.clock.setHour(self.hour.get()) 

36 self.clock.setMinute(self.minute.get()) 

37 self.clock.setSecond(self.second.get()) 

38 

39 DisplayClock() # Create GUI 


create entries 


create button 
callback handler 


setNewTime 


create GUI 



( 0 , 0 ) 



(a) (b) 

Figure 12.4 (a) The Di spl ayCl ock program displays a clock and enables the user to change the time, (b) The 

endpoint of a clock hand can be determined, given the spanning angle, the hand length, and the center point. 


The rest of this section explains how to implement the Still Cl ock class. Since you can 
use the class without knowing how it is implemented, you may skip the implementation if you skip implementation? 
wish. 

How do you obtain the current time? Python provides the datetime class, which can be obtain current time 
used to obtain the current computer time. You can use the nowC) function to return an 
instance of datetime for the current time, and use the data fields year, month, day, hour. 
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draw a clock 


extend Canvas 
initializer 


minute, and second to extract date and time information from the object, as shown in the 
following code; 

from datetime import datetime 

d = datetime.now() 

pri ntC'Current year is", d.year) 

pri ntC'Current month is", d.month) 

pri ntC'Current day of month is", d.day) 

pri ntC'Current hour is", d.hour) 

pri ntC'Current minute is", d.minute) 

pri ntC'Current second is", d.second) 

To draw a clock, you need to draw a circle and three hands for the second, minute, and 
hour. To draw a hand, you need to specify the two ends of the line. As shown in Figure 12.4b, 
one end is at the center of the clock at (xCenter, yCenter); the other end, at (xEnd, 
yEnd), is determined by the following formula: 

xEnd = xCenter + handLength x sin(0) 
yEnd = yCenter - handLength x cos(0) 

Since there are 60 seconds in one minute, the angle 0 (see Figure 12.4b) for the second 
hand is: 

0 = second x (27i/60) 

The position of the minute hand is determined by the minute and second. The exact minute 
value combined with seconds is minute + second/60. For example, if the time is 3 min¬ 
utes and 30 seconds, the total minutes are 3.5. Since there are 60 minutes in one hour, the 
angle for the minute hand is: 

0 = (minute + second/60) x (Ztt/GO) 

Since one circle is divided into 12 hours, the angle for the hour hand is: 

0 = (hour + minute/60 + second/(60 x 60)) x (27i/12) 

For simplicity in computing the angles of the minute hand and hour hand, you can omit the 
seconds, because they are negligibly small. Therefore, the endpoints for the second hand, 
minute hand, and hour hand can be computed as: 

xSecond = xCenter + secondHandLength x sin(second x (27t/60)) 
ySecond = yCenter - secondHandLength x cos(second x (27t/60)) 
xMinute = xCenter + minuteHandLength x sin(minute x (27t/60)) 
yMinute = yCenter - minuteHandLength x cos(minute x (27i/60)) 
xHour = xCenter + hourHandLength x sin((hour + minute/60) x (27i/12)) 
yHour = yCenter - hourHandLength x cos((hour + minute/60) x (27i/12)) 

The Still Clock class is implemented in Listing 12.9. 

Listing 12.9 Still Cl ock.py 

1 from tkinter import * # Import all definitions from tkinter 

2 import math 

3 from datetime import datetime 

4 

5 class StinClock(Canvas) : 

6 def _ _init_(self, container): 

7 super()._init_(container) 


8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 

60 

61 

62 

63 

64 

65 

66 

67 
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self.setCurrentTime() 

def getHour(self): 

return self._hour 

def setHour(self, hour); 

self._hour = hour 

self.delete ("clock") 
self .drawClockO 

def getMinute(self): 

return self._minute 

def setMinute(self, minute): 

self._minute = minute 

self.delete ("clock") 
self .drawClockO 

def getSecond(self): 

return self._second 

def setSecond(self, second): 

self._second = second 

self.delete ("clock") 
self .drawClockO 

def setCurrentTime(self): 
d = datetime.now() 

self._hour = d.hour 

self. minute = d.minute 

self. second = d.second 

self.delete ("clock") 
self .drawClockO 

def drawClock(self): 

width = float(self ["width"] ) 
height = float(self ["height"] ) 
radius = min(width, height) / 2.4 
secondHandLength = radius * 0.8 
minuteHandLength = radius * 0.65 
hourHandLength = radius * 0.5 

self.create_oval(width / 2 - radius, height / 2 - radius, 
width / 2 + radius, height / 2 + radius, tags = "clock") 
self.create_text(width / 2 - radius + 5, height / 2, 
text = "9", tags = "clock") 
self.create_text(width / 2 + radius - 5, height / 2, 
text = "3", tags = "clock") 
self.create_text(width / 2, height / 2 - radius + 5, 
text = "12", tags = "clock") 
self.create_text(width / 2, height / 2 + radius - 5, 
text = "G", tags = "clock") 

xCenter = width / 2 
yCenter = height / 2 

second = self._second 

xSecond = xCenter + secondHandLength \ 

* math.sin(second * (2 * math.pi / 60)) 
ySecond = yCenter - secondHandLength \ 

* math.cos(second * (2 * math.pi / 60)) 


getHour 


setHour 


set current time 


draw clock 
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68 

69 

70 

71 

72 

73 

74 

75 

76 

77 

78 

79 

80 
81 
82 

83 

84 

85 

86 

87 

88 
89 


self.create_line(xCenter, yCenter, xSecond, ySecond, 
f-ill = "red", tags = "clock") 

minute = self._minute 

xMinute = xCenter + \ 

minuteHandLength * math.sin(minute * (2 * math.pi / 60)) 
yMinute = yCenter - \ 

minuteHandLength * math.cos(minute * (2 * math.pi / 60)) 
self.create_line(xCenter, yCenter, xMinute, yMinute, 
fill = "blue", tags = "clock") 

hour = self._hour % 12 

xHour = xCenter + hourHandLength * \ 

math.sin((hour + minute / 60) * (2 * math.pi / 12)) 
yHour = yCenter - hourHandLength * \ 

math.cos((hour + minute / 60) * (2 * math.pi / 12)) 
self.create_line(xCenter, yCenter, xHour, yHour, 
fill = "green", tags = "clock") 

timestr = str(hour) + + str(minute) + + str(second) 

self.create_text(width / 2, height / 2 + radius + 10, 
text = timestr, tags = "clock") 


The Still Clock class extends the Canvas widget (line 5), so a Still Clock is a 
Canvas. You can use Stil 1 Clock just like a canvas. 

The Still Clock class’s initializer invokes the Canvas initializer (line 7), then sets the 
data fields hour, minute, and second using the current time by invoking the 

setCurrentTime method (line 8). 

The data fields hour, mi nute, and second are accompanied by the get and set methods to 
retrieve and set these data fields (lines 10-32). When a new value is set for the hour, minute, 
or second, the drawClock method is invoked to redraw the clock (lines 16, 24, and 32). 

The setCurrentTime method gets the current time by invoking datetime. nowC) (line 
35) to obtain the current hour, minute, and second (lines 36-38), and invokes the drawClock 
method to redraw the clock (line 40). 

The drawClock method obtains the width and height of the canvas (lines 43-44) and sets 
the appropriate size for the hour hand, minute hand, and second hand (lines 45-48). It then 
uses Canvas’s drawing methods to draw a circle, lines, and text strings for displaying a clock 
(lines 50-89). 


V' /Point 


12.8 Class Relationships 

To design classes, you need to explore the relationships among classes. The common 
relationships among classes are association, aggregation, composition, and 
inheritance. 


You have already used inheritance to model the is-a relationship. We now explore other 
relationships. 


12.8.1 Association 

association Association is a general binary relationship that describes an activity between two classes. For 

example, a student taking a course is an association between the Student class and the 
Course class, and a faculty member teaching a course is an association between the Facul ty 
class and the Course class. These associations can be represented in UML graphical nota¬ 
tion, as shown in Figure 12.5. 
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Take ^ -4 Teach 

i j..0 sj; I L)..3 i k 

- Course I - Faculty I 

- ‘ Teacher ' 

Figure 12.5 This UML diagram shows that a student may take any number of courses, a 
faculty member may teach at most three courses, a course may have from five to sixty stu¬ 
dents, and a course is taught by only one faculty member. 


An association is illustrated by a solid line between two classes with an optional label that 
describes the relationship. In Figure 12.5, the labels are Take and Teach. Each relationship 
may have an optional small black triangle that indicates the direction of the relationship. In 
this figure, the direction indicates that a student takes a course (as opposed to a course taking 
a student). 

Each class involved in the relationship may have a role name that describes the role it plays 
in the relationship. In Figure 12.5, teacher is the role name for Facul ty. 

Each class involved in an association may specify a multiplicity. A multiplicity could be a multiplicity 
number or an interval that specifies how many of the class’s objects are involved in the rela¬ 
tionship. The character * means an unlimited number of objects, and the interval m. . n indi¬ 
cates that the number of objects is between m and n, inclusively. In Eigure 12.5, each student 
may take any number of courses, and each course must have at least five and at most sixty stu¬ 
dents. Each course is taught by only one faculty member, and a faculty member may teach 
from zero to three courses per semester. 

In Python code, you can implement associations by using data fields and methods. Eor 
example, the relationships in Figure 12.5 may be implemented using the classes in Figure 
12.6. The relation “a student takes a course” is implemented using the addCourse method in 
the Student class and the addStudent method in the Course class. The relation “a faculty 
teaches a course” is implemented using the addCourse method in the Facul ty class and the 
setFaculty method in the Course class. The Student class may use a list to store the 
courses that the student is taking, the Facul ty class may use a list to store the courses that 
the faculty is teaching, and the Course class may use a list to store students enrolled in the 
course and a data field to store the instructor who teaches the course. 


class Student; 


class Course: 


class Faculty: 

# Add course to a list 


# Add student to a list 


# Add course to a list 

def addCourse(self, 


def addStudent(self, 


def addCourse(self, 

course): 


student): 


course): 



def setFacultyCself, faculty): 




Figure 12.6 The association relations are implemented using data fields and methods in classes. 


12.8.2 Aggregation and Composition 

Aggregation is a special form of association that represents an ownership relationship 
between two objects. Aggregation models has-a relationships. The owner object is called an 
aggregating object, and its class is called an aggregating class. The subject object is called an 
aggregated object, and its class is called an aggregated class. 

An object can be owned by several other aggregating objects. If an object is exclusively 
owned by an aggregating object, the relationship between the object and its aggregating 
object is referred to as a composition. For example, “a student has a name” is a composition 
relationship between the Student class and the Name class, whereas “a student has an 
address” is an aggregation relationship between the Student class and the Address class. 


aggregation 

aggregating object 
aggregating class 
aggregated object 
aggregated class 
composition 
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since an address can be shared by several students. In UML, a filled diamond is attached to an 
aggregating class (in this case, Student) to denote the composition relationship with an 
aggregated class (Name), and an empty diamond is attached to an aggregating class 
(Student) to denote the aggregation relationship with an aggregated class (Address), as 
shown in Figure 12.7. 


Address [ 


In Figure 12.7, each student has only one multiplicity—address—and each address can be 
shared by up to 3 students. Each student has one name, and a name is unique for each student. 

An aggregation relationship is usually represented as a data field in the aggregating class. 
For example, the relationships in Figure 12.7 may be implemented using the classes in Figure 
12.8. The relation “a student has a name” and “a student has an address” are implemented in 
the data field name and address in the Student class. 


Composition Aggregation 


Name 


1 A .A 1 

Student 




Figure 12.7 Each student has a name and an address. 


class Name: 


class Student: 

def _init_(self, name, addresses) 
self.name = name 
self.address = address 


class Address: 

Aggregated class 

Aggregating class 

Aggregated class 


Figure 12.8 The composition relations are implemented using data fields in classes. 


Aggregation can exist between objects of the same class. Eor example. Figure 12.9a illus¬ 
trates that a person can have a supervisor. 


Person 





Person 




Supervisor 

m 




Supervisor 


(a) (b) 

Figure 12.9 (a) A person can have a supervisor, (b) A person can have several supervisors. 


The relationship “a person has a supervisor” can be represented as a data field in the 
Person class, as follows: 

class Person: 

# The type for the data is the class itself 

def _ _init_(self, supervisor) 

self.supervisor = supervisor 
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If a person has several supervisors, as shown in Figure 12.9b, you can use a list to store 
supervisors. 



Note 

Because aggregation and composition relationships are both implemented in classes in 
similar ways, for simplicity, we refer to both as compositions. 


aggregation or composition 


12.17 What are the common types of relationships among classes? Describe the UML 
graphical notation for modeling the relationships among classes. 

12.18 What relationship is appropriate for the following classes? Draw the relationships 
using UML diagrams. 


W P( 


heck 

Point 


MyProgrammingLab" 


Company and Employee 
Course and Faculty 
Student and Person 


House and Window 
Account and Savings Account 


12.9 Case Study: Designing the Course Class 

This section designs a class for modeling courses. 

Suppose you need to process course information. Each course has a name and has students 
enrolled. You want to be able to add/drop a student to/from the course. You can use a class to 
model the courses, as shown in Figure 12.10. 


rr/Key 
«r^ / Point 


Course 

-courseName: str 
-students: list 

CourseCcourseName: str) 
getCourseNameO : str 
addStudentfstudent: str): None 
dropStudentfstudent: str): None 
getStudentsO : list 
getNumberOfStudentsO: int 


The name of the course. 

A list to store the students in the course. 

Creates a course with the specified name. 
Returns the course name. 

Adds a new student to the course. 

Drops a student from the course. 

Returns the students in the course. 

Returns the number of students in the course. 


Figure 12.10 The Course class models the courses. 


A Course object can be created using the constructor Course (name) by passing a course 
name. You can add students to the course using the addStudent(student) method, drop a 
student from the course using the dropStudent (student) method, and return the names of 
all the students in the course using the getStudentsO method. Suppose the Course class is 
available. Listing 12.10 gives a test program that creates two courses and adds students to them. 

Listing 12.10 TestCourse.py 

1 from Course import Course 

2 

3 def mai n () : 
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create a course 

4 

course! = Course( 'Data Structures' ) 


5 

C 

course2 = Course ('Database Systems') 

add a student 

D 

7 

coursel.addStudent( .’eter Jones' ) 


8 

coursel.addStudent ("Brian Smith") 


9 

course!.addStudent ("Anne Kennedy") 


10 



11 

course2.addStudent( Peter Jones' ) 


12 

course2. addStudent("Steve Smith") 


13 



14 

pri ntC'Number of students in coursel:" 

number of students 

15 

coursel.getNumberOfStudents()) 

return students 

16 

students = coursel.getStudentsO 


17 

for student in students: 


18 

print(student, end = ", ) 


19 



20 

pri nt("\nNumber of students in course2 


21 

course2 .getNumberOfStudentsO) 


22 



23 

mainO # Call the main function 


Number of students in counsel: 3 
Peter Jones, Brian Smith, Anne Kennedy, 
Number of students in course2: 2 


students list 


add a student 


return students 


number of students 


The Course class is implemented in Listing 12.11. It uses a list to store the students for the 
course in line 4. The addStudent method (line 6) adds a student to the list. The 
getStudents method returns the list (line 9). The dropStudent method (line 18) is left as 
an exercise. 

Listing 12.11 Course, py 

1 class Course: 

2 def _ _init (self, courseName): 

3 self._courseName = courseName 

4 self._students = [] 

5 

6 def addStudent(self, student): 

7 self._students.append(student) 

8 

9 def getStudents(self): 

10 return self._students 

11 

12 def getNumberOfStudents(self): 

13 return len(self. students) 

14 

15 def getCourseName(self): 

16 return self._courseName 

17 

18 def dropStudent(student): 

19 printC'Left as an exercise") 

When you create a Course object, a list object is created. A Course object contains a ref¬ 
erence to the list. For simplicity, you can say that the Course object contains the list. 

The user can create a Course and manipulate it through the public methods addStudent, 
dropStudent, getNumberOfStudents, and getStudents. However, the user doesn’t 
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need to know how these methods are implemented. The Course class encapsulates the inter¬ 
nal implementation. This example uses a list to store the names of students. You may use a 
different data type to store student names. The program that uses Course does not need to 
change as long as the contract of the public methods remains unchanged. 


12.10 Designing a Class for Stacks 

This section designs a class for modeling stacks. 

Recall that a stack (see Chapter 6) holds data in a last-in, first-out fashion, as shown in 
Figure 12.11. 


V / Point 


Datal- 


Data2 — 


DataB— 










DataB 






Data2 


Data2 




Datal 


Datal 


Datal 

Data3 

'A 

Data2 

A 

Datal-<— 

'A 



Data2 







Datal 


Datal 





Figure 12.11 Datal, Data2, and Data3 are pushed onto the stack in this order and popped 
out in the reversed order. 


Stacks have many applications. For example, a computer uses a stack to process function stack 
invocations. When a function is invoked, an activation record that stores its parameters and 
local variables is pushed onto a stack. When a function calls another function, the new func¬ 
tion’s activation record is pushed onto the stack. When a function finishes its work and returns 
to its caller, its activation record is removed from the stack. 

You can define a class to model stacks and use a list to store the elements in a stack. There 
are two ways to design a stack class: 

■ Using inheritance, you can define a stack class by extending list, as shown in inheritance 
Figure 12.12a. 

■ Using composition, you can create a list as a data field in the Stack class, as shown composition 
in Figure 12.12b. 


list M-. Stack I list I — ^ Stack | 

(a) Using inheritance (b) Using composition 

Figure 12.12 Stack may be implemented using inheritance or composition. 

Both designs are fine, but using composition is better because it enables you to define a 
completely new stack class without inheriting the unnecessary and inappropriate methods 
from the list class. We use the composition approach in this section and leave you to imple- composition 

ment the inheritance approach in Exercise 12.16. The UML diagram for the Stack class is inheritance 

shown in Figure 12.13. 

Suppose that the Stack class is available. The test program in Listing 12.12 uses the class 
to create a stack (line 3), store ten integers 0, 1, 2, ..., and 9 (lines 5-6), and display them in 
reverse order (line 9). 
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create a stack 


push onto stack 


pop from stack 


Stack 

-elements: list 
StackO 

isEmptyC): bool 
peek(): object 

push(value: object): None 
popC): object 
getSizeC): int 


A list to store the elements in the stack. 

Constructs an empty stack. 

Returns True if the stack is empty. 

Returns the element at the top of the stack without 
removing it from the stack. 

Stores an element at the top of the stack. 

Removes the element at the top of the stack and returns it. 

Returns the number of elements in the stack. 


Figure 12.13 The Stack class encapsulates the stack storage and provides the operations 
for manipulating the stack. 


Listing 12.12 TestStack.py 

1 from Stack import Stack 

2 

3 stack = StackO 

4 

5 for i in rangeflO): 

6 stack.push(i) 

7 

8 while not stack.isEmptyO : 

9 printfstack.popO, end = ) 


9876543210 


How do you implement the Stack class? You can use a list to store the elements in a stack, 
as shown in Listing 12.13. 


Listing 12.13 Stack, py 



1 

class Stack: 


2 

def _i ni t_(sel f) : 

list to store elements 

3 

A 

self._elements = [] 


4 

5 

# Return True if the stack is empty 

isEmpty 

6 

def isEmptyCself): 


7 

o 

return lenfself._elements) == 0 


o 

9 

# Return the element at the top of the stack 


10 

# without removing it from the stack. 

peek 

11 

def peek(self): 


12 

if self .isEmptyO : 


13 

return None 


14 

e1 se : 


15 

return self._elements[len(elements) - 1] 


16 



17 

# Store an element at the top of the stack 

push 

18 

def pushfself, value): 


19 

self._elements.append(value) 
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20 

21 # Remove the element at the top of the stack and return it 

22 def pop(self): pop 

23 if self .isEmptyO : 

24 return None 

25 else: 

26 return self. elements. pop() 

27 

28 # Return the size of the stack 

29 def getSize(self): getSize 

30 return len(self._elements) 

In line 3, the data field elements is defined as private with two leading underscores, 
el ements is a list, hut the client is not aware that the elements in the stack are stored in a list. 

The client accesses the stack through the methods isEmptyO, peek(), push (element), 
popO, and getSizeC). 


1 2. 11 Case Study: The FigureCanvas Class 

This case study develops the FigureCanvas class for displaying various figures. 

The FigureCanvas class enables the user to set the figure type, specify whether the figure is 
filled, and display the figure on a canvas. The UML diagram for the class, which can display 
lines, rectangles, ovals, and arcs, is shown in Figure 12.14. The figureType property 
decides which figure to display. If the f i 11 ed property is True, the rectangle, oval, or arc is 
filled with a color. 


tr/Key 
r /Point 


tkinter.Canvas 

-- 


FigureCanvas 


-figureType: str 
-filled: bool 


FigureCanvas(container, figureType, 
filled, width, height) 


The get and set methods for these data fields 
are provided in the class, but they are 
omitted from the UML diagram for brevity. 




Specifies the figure type (line, rectangle, oval, or arc). 

Specifies whether the figure is filled (default: False). 

Creates a figure canvas inside a container with the specified figure 
type, filled, width (default 200), and height (default 200). 


Figure 12.14 The FigureCanvas class displays various types of figures on the panel. 


The UML diagram serves as the contract for the FigureCanvas class. The user can use 
the class without knowing how the class is implemented. We will begin by writing the pro¬ 
gram in Listing 12.14 that uses the class to display seven figures in a panel, as shown in 
Figure 12.15. 

Listing 12.14 DisplayFigures.py 

1 from tkinter import * # Import all definitions from tkinter 

2 from FigureCanvas import FigureCanvas import FigureCanvas 

3 

4 class DisplayFigures: 

5 def _init_(self): 

6 window = Tk() # Create a window 

7 window.title ("Display Figures") # Set title 
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create figure 
place figure 


create GUI 


8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 


figurel = FigureCanvas (window, '1 
figurel.grid(row = 1, column = 
figure2 = FigureCanvas(window, 
figure2.grid(row = 1, column = 
figure3 = FigureCanvas(window, 
figure3.grid(row = 1, column = 
figure4 = FigureCanvas(window, 
figure4.grid(row = 1, column = 
figure5 = FigureCanvas(window, 
figure5.grid(row = 1, column = 
figure6 = FigureCanvas(window, 
figure6.grid(row = 1, column = 
figure? = FigureCanvas(window, 
figure?.grid(row = 1, column = 

window.mainloopO # Create an ( 


ine' , width = 100, height = 

= 100) 

1) 

"rectangle". False, 

, 100, 

100) 

2) 

'oval". False, 100 

, 100) 


3) 

'arc". False, 100, 

100) 


4) 

'rectangle". True, 

100, 

100) 

5) 

'oval". True, 100, 

100) 


6) 

"arc". True, 100, 

100) 


7) 

5vent loop 




DisplayFiguresO # Create GUI 



extend Canvas 


superclass initializer 


draw figure 


set figure type 


The FigureCanvas class is implemented in Listing 12.15. Four types of figures are 
drawn according to the figureType property (lines 26-34). 


Listing 12.15 FigureCanvas. py 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 
1 ? 
18 

19 

20 
21 
22 


from tkinter import * # Import all definitions from tkinter 
cl ass Figu reCanvas(Canvas): 

def _init_(self, container, figureType, filled = False, 

width = 100, height = 100); 

superO ._i ni t_(contai ner, 

width = width, height = height) 

self._figureType = figureType 

self._filled = filled 

self.drawFigure() 

def getFigureType(self): 

return self._figureType 

def getFi11ed(self): 

return self._filled 

def setFigureType(self, figureType): 

self._figureType = figureType 

self.drawFigure() 

def setFi11ed(self, filled): 


set fill 
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23 self. filled = filled 

24 self .drawFigureO 

25 


26 

def drawFigure(self): 


draw figure 

27 

if self._figureType == "line": 



28 

self .lineO 



29 

elif self._figureType == "rectangle": 



30 

self.rectangle() 



31 

elif self._figureType == "oval": 



32 

self.oval 0 



33 

elif self._figureType == "arc": 



34 

self.arc() 



35 




36 

def line(self): 


draw lines 

37 

width = int(self ["width"]) 



38 

height = int(self ['height"]) 



39 

self .create_line(10, 10, width - 10, height - 10) 



40 

self.create_line(width - 10, 10, 10, height - 10) 



41 




42 

def rectangle(self): 



43 

width = int(self ["width"]) 



44 

height = int(self[ "height"] ) 



45 

if self._filled: 



46 

self.create_rectangl e(10 , 10, width - 10, height - 

10, 

fill a rectangle 

47 

fill = "red") 



48 

el se : 



49 

self.create_rectangl e(10 , 10, width - 10, height - 

10) 

draw a rectangle 

50 




51 

def oval (sel f) : 



52 

width = int(self ["width"] ) 



53 

height = int(self ["height"]) 



54 

if self._filled: 



55 

self.create_oval (10 , 10, width - 10, height - 10, 


fill an oval 

56 

fill = "red") 



57 

el se : 



58 

self.create_oval (10, 10, width - 10, height - 10) 


draw an oval 

59 




60 

def arc(self): 



61 

width = int(self ["width"] ) 



62 

height = int(self ["height"]) 



63 

if self._filled: 



64 

self. create_arc(10 , 10, width - 10, height - 10, 


fill an arc 

65 

start = 0, extent = 145, fill = "red") 



66 

el se : 



67 

self .create_arc(10, 10, width - 10, height - 10, 


draw an arc 

68 

start = 0, extent = 145) 




The FigureCanvas class extends the Canvas widget (line 3). Thus, a FigureCanvas is 
a canvas, and you can use FigureCanvas just like a canvas. You can construct a 
FigureCanvas by specifying the container, figure type, whether the figure is filled, and the 
canvas width and height (lines 4-5). 

The FigureCanvas class’s initializer invokes the Canvas initializer (lines 6-7), sets the 
data field’s figureType and filled properties (lines 8-9), and invokes the drawFigure 
method (line 10) to draw a figure. 

The drawFigure method draws a figure based on the figureType and filled proper¬ 
ties (lines 26-34). 

The methods line, rectangle, oval, and arc draw lines, rectangles, ovals, and arcs 
(lines 36-68). 
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Key Terms 


aggregation 419 
association 418 
composition 419 
dynamic binding 410 
inheritance 400 


is-a relationships 404 
multiple inheritance 404 
override 405 
polymorphism 409 


Chapter Summary 


1. You can derive a new class from an existing class. This is known as class inheritance. 
The new class is called a subclass, child class or extended class. The existing class is 
called a superclass, parent class, or base class. 

2. To override a method, the method must be defined in the subclass using the same 
header as in its superclass. 

3. The object class is the root class for all Python classes. The methods _str_() 

and _eq_(other) are defined in the object class. 

4" Polymorphism means that an object of a subclass can be passed to a parameter of a 
superclass type. A method may be implemented in several classes along the inheri¬ 
tance chain. Python decides which method is invoked at runtime. This is known as 
dynamic binding. 

5. The i sinstance function can be used to determine whether an object is an instance 
of a class. 

6. The common relationships among classes are association, aggregation, composition, 
and inheritance. 

Test Questions 

Do test questions for this chapter online at www.cs.armstrong.edu/liang/py/test.html. 


MyProgrammingLab" PROGRAMMING EXERCISES 


Sections 12.2-12.6 

12.1 {The Triangle class) Design a class named Triangle that extends the 

GeometricObject class. The Triangle class contains: 

■ Three float data fields named sidel, sideZ, and sideS to denote the three 
sides of the triangle. 

■ A constructor that creates a triangle with the specified sidel, sideZ, and 
sides with default values 1.0. 

■ The accessor methods for all three data fields. 

■ A method named getAreaC) that returns the area of this triangle. 

■ A method named getPeri meter () that returns the perimeter of this triangle. 

■ A method named _str _() that returns a string description for the triangle. 






Programming Exercises 429 


For the formula to compute the area of a triangle, see Exercise 2.14. The 
__str__0 method is implemented as follows: 

return "Triangle: sidel = " + str(sidel) + " side2 = " + 
str(side2) + " sideB = " + str(side3) 

Draw the UML diagrams for the classes Triangle and GeometricObject. 
Implement the Triangle class. Write a test program that prompts the user to 
enter the three sides of the triangle, a color, and 1 or 0 to indicate whether the tri¬ 
angle is filled. The program should create a Triangl e object with these sides and 
set the color and filled properties using the input. The program should display the 
triangle’s area, perimeter, color, and True or Fal se to indicate whether the trian¬ 
gle is filled or not. 

** 12.2 {The Location class) Design a class named Location for locating a maximal 
value and its location in a two-dimensional list. The class contains the public data 
fields row, col umn, and maxVal ue that store the maximal value and its indexes in 
a two-dimensional list, with row and column as int types and maxValue as a 
float type. 

Write the following method that returns the location of the largest element in a 
two-dimensional list. 

def Location 1ocateLargest(a) : 

The return value is an instance of Location. Write a test program that prompts 
the user to enter a two-dimensional list and displays the location of the largest ele¬ 
ment in the list. Here is a sample run: 


Enter the number of rows and columns in the 

list: 3, 4 

E Enter | 

Enter row 0: 

23.5 35 2 10 pirtT] 



Enter row 1: 

4.5 3 45 3.5 



Enter row 2: 

35 44 5.5 12.6 



The location 

of the largest element is 45 at 

(1, 2) 




** 12.3 {Game: ATM machine) Use the Account class created in Exercise 7.3 to simulate 
an ATM machine. Create ten accounts in a list with the ids 0, 1, ..., 9, and an ini¬ 
tial balance of $100. The system prompts the user to enter an id. If the id is entered 
incorrectly, ask the user to enter a correct id. Once an id is accepted, the main 
menu is displayed as shown in the sample run. You can enter a choice of 1 for 
viewing the current balance, 2 for withdrawing money, 3 for depositing money, 
and 4 for exiting the main menu. Once you exit, the system will prompt for an id 
again. So, once the system starts, it won’t stop. 


Enter an account id: 4 [ -I Enter 

Main menu 
1: check balance 
2: withdraw 
3: deposit 
4: exit 
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Enter a choice: 1 I^Enter 
The balance is 100.00 


Main menu 
1: check balance 
2: withdraw 
3: deposit 
4: exit 

Enter a choice: 2 


Enter an amount to withdraw: 


Main menu 
1: check balance 
2: withdraw 
3: deposit 
4: exit 

Enter a choice: 1 Enter| 
The balance is 97.00 


Main menu 


check balance 
withdraw 
deposit 
exi t 


Enter a choice: 3 I^Ente^ 

Enter an amount to deposit: 10 


Main menu 
1: check balance 
2: withdraw 
3: deposit 
4: exit 

Enter a choice: 1 
The balance is 107.00 


Main menu 
1: check balance 
2: withdraw 
3: deposit 
4: exit 

Enter a choice: 4 


Enter an account id: 


*12.4 (Geometry: find the bounding rectangle) A bounding rectangle is the minimum 
rectangle that encloses a set of points in a two-dimensional plane, as shown in 
Figure 12.16. Write a method that returns a bounding rectangle for a set of points 
in a two-dimensional plane, as follows: 

def getRectangleCpoints): 

You defined the RectangleZD class in Exercise 8.19. Write a test program that 
prompts the user to enter the points as xl yl x2 y2 x3 y3 ... in one line, and dis¬ 
plays the bounding rectangle’s center, width, and height. Here is a sample run: 
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Enter the points: 1.0 2.5 3456789 10 Enter | 

The bounding rectangle is centered at (5.0, 6.25) with width 
8.0 and height 7.5 




Figure 12.16 Points are enclosed inside a rectangle. 


Sections 12.7-12.11 

** 12.5 (Game: Tic-tac-toe) Write a program that plays the tic-tac-toe game. Two players 
take turns clicking an available cell in a 3 X 3 grid with their respective tokens 
(either X or O). When one player has placed three tokens in a horizontal, vertical, 
or diagonal row on the grid, the game is over and that player has won. A draw (no 
winner) occurs when all the cells in the grid have been filled with tokens and nei¬ 
ther player has achieved a win. Figure 12.17 shows the representative sample runs 
of the example. 


'ft TirTarTnr loll J^ l w QMlI 

xoD'i 

□xo 

□□X 

X won! The game is over 


(a) The X player won the game (b) Draw—no winners 

Figure 12.17 Two players play a tic-tac-toe game. 


7^ TlrT^.rTnP 

xoo 

OXX i 

xxo 

Draw! The game is over 


T’i TicTacToe I— 

■I xxo I 

XOD 

ODD 

0 won! The game is over 
(c) The O player won the game 


Assume that all the cells are initially empty, and that the first player takes the X 
token and the second player the O token. To mark a cell, the player points the 
mouse to the cell and clicks it. If the cell is empty, the token (X or O) is displayed. 
If the cell is already filled, the player’s action is ignored. 

Define a custom class named Cel 1 that extends Label for displaying a token and 
for responding to the button-click event. The class contains a data field token with 
three possible values— , X, and —that denote whether the cell has been occu¬ 
pied and which token is used in the cell if it is occupied. 

The three image files x.gif, o.gif, and empty.gif can be obtained from 
cs.armstrong.edu/liang/py/book.zip in the image folder. Use these three images 
to display the X, O, and empty cells. 

** 12.6 {Tkinter: two circles intersect?) Using the CircleZD class you defined in Exer¬ 
cise 8.18, write a program that enables the user to point the mouse inside a circle 
and drag it. As the circle is being dragged, the label displays whether two circles 
overlap, as shown in Figure 12.18. 
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(a) (b) 


Figure 12.18 Check whether two circles are overlapping. 


** 12.7 (Tkinter: two rectangles intersect?) Using the Rectangl e2D class you defined in 
Exercise 8.19, write a program that enables the user to point the mouse inside a 
rectangle and drag it. As the rectangle is being dragged, the label displays whether 
two rectangles overlap, as shown in Figure 12.19. 


7i^ Two Rectangles 



Two rectangles intersect 


rl 


r2 





(a) (b) 

Figure 12.19 Check whether two rectangles are overlapping. 


** 12.8 {Tkinter: two circles intersect?) Using the CircleZD class you defined in Exer¬ 
cise 8.18, write a program that enables the user to specify the location and size of 
two circles and displays whether the circles intersect, as shown in Figure 12.20. 
Enable the user to point the mouse inside a circle and drag it. As a circle is being 
dragged, the program updates the circle’s center coordinates and its radius in the 
text fields. 


Two circles intersect 


G 

o 


Cl Centers 

134 C2 Center K 

90 

Cl Centery: 

51 C2 Centery: 

61 

Cl Radius: 

3f).0 C2 Radius: 

20.0 

Redraw Circles | 



Two Circles 


Two circles don't intersect 


© 



Cl Center x: 189 C2 Center x; ] 90 

Cl Centery:[ 51 C2 Centery; 61 

Cl Radius: 4)'0 C2 Radius: ] 20.0 
Redraw Circles 


Figure 12.20 Check whether two circles are overlapping. 


** 12.9 {Tkinter: two rectangles intersect?) Using the Rectangle2D class you defined in 
Exercise 8.19, write a program that enables the user to specify the location and 
size of the rectangles and displays whether the two rectangles intersect, as shown 
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in Figure 12.21. Enable the user to point the mouse inside a rectangle and drag it. 
As a rectangle is being dragged, the program updates the rectangle’s center coor¬ 
dinates, width, and height in the text fields. 



Two rectangles don't intersect 

0 ^ 


R1 Center X 172 R2 Center x 

109 

R1 Center y: 47 R2 Center y; 

66 

R1 Width: 60 R2 Width: 

30 

R1 Height 50 R2 Height 

30 

Redraw Rectangles | 



Two Rectangles 




Two rectangles intersect 



rl 

r2 



R1 C enter x: j 
R1 C enter y; [ 
R1 Width: [ 
R1 Height 


149 R2 Center X I 109 
44 R2 Center y: I 66 
"lo R2 Width: I 30 
30 R2 Height 30 


Redraw Rectangles 


Figure 12.21 Check whether two rectangles are overlapping. 


** 12.10 {Tkinter: four cars) Write a program that simulates four cars racing, as shown in 
Figure 12.22. You should define a subclass of Canvas to display a car. 




Figure 12.22 The program simulates four cars racing. 


**I2.I I {Tkinter: guess birthday) Listing 4.3, GuessBirthday.py, gives a program for 
guessing a birthday. Create a program for guessing birthdays as shown in Figure 
12.23. The program prompts the user to check whether the date is in any of the 
five sets. The date is displayed in a message box upon clicking the Guess Birth¬ 
day button. 

*12.12 {Tkinter: a group of clocks) Write a program that displays four clocks, as shown in 
Figure 12.24. 


^4 Guess Birthday ^ 




Check the boxes If your birthday is in these sets 

13 5 7 

9 11 13 15 

j 17 19 21 23 

^ 25 27 29 31 

1 ^ 

2 3 6 7 

10 11 14 15 

18 19 22 23 

26 27 29 31 

r 

4 5 6 7 

12 13 14 15 

20 21 22 23 

28 29 30 31 

[7 

Guess Birthday 

8 9 10 11 

12 13 14 15 

24 25 26 27 

28 29 30 31 

r 

16 17 18 19 

20 21 22 23 

24 25 26 27 

28 29 30 31 

r 


Found it 




Your birthday is 5 


OK 


Figure 12.23 This program guesses the birthdays. 
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Figure 12.24 

***12.13 


Figure 12.25 

**12.14 



The program displays four clocks. 


{Tkinter: Connect Four game) In Exercise 11.20, you created a Connect Four 
game that enables two players to play the game on the console. Rewrite the pro¬ 
gram using a GUI program, as shown in Figure 12.25. The program enables 
two players to place red and yellow disks in turn. To place a disk, the player 
needs to click on an available cell. An available cell is unoccupied and its 
downward neighbor is occupied. The program flashes the four winning cells if 
a player wins, and reports no winners if all cells are occupied with no winners. 




□ □□□□□□I 
□□□□□□□ 
□□□□□□□ 
□□□□□□□ 
□□□□□□□ 

□□□□□□□ 

Start Over 


The program enables two players to play the Connect Four game. 


□ □□□□□□I 
□□□□□□□ 
□□□□□□□ 
□□□□□□□ 
□□□□□□□ 

□□□□□□□ 

Start^OverJ| 


{Tkinter: Mandelbrot fractal) The Mandelbrot fractal is a well-known image 
created from a Mandelbrot set (see Figure 12.26a). A Mandelbrot set is defined 
using the following iteration: 


c is a complex number, and the starting point of the iteration is zq = 0. (For 
information on complex numbers, see Exercise 8.21.) For a given c, the iteration 
will produce a sequence of complex numbers: [zq, Zi, ... , z„, ... ]. It can be 
shown that the sequence either tends to infinity or stays bounded, depending on 
the value of c. For example, if c is 0, the sequence is [0, 0, ... ], which is 
bounded. If c is i, the sequence is [0, i, —1 + i, —i, —I + i, i, ... ], which 
is bounded. If c is 1 + i, the sequence is [0, 1 -T i, 1 + 3i, . . . ], which is 
unbounded. It is known that if the absolute value of a complex value z,- in the 
sequence is greater than 2, then the sequence is unbounded. The Mandelbrot set 
consists of the c value such that the sequence is bounded. For example, 0 and i 
are in the Mandelbrot set. A Mandelbrot image can be created using the follow¬ 
ing code: 

1 C0UNT_LIMIT = 60 

2 

3 # Paint a Mandelbrot image in the canvas 
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4 def pan nt(): 

5 X = -2.0 

6 while X < 2.0: 

7 y = -2.0 

8 while y < 2.0: 

9 c = count(complex(x, y)) 

10 if c == C0UNT_LIMIT: 

11 color = "red" # c is in a Mandelbrot set 

12 else : 

13 # get hex value RRGGBB that is dependent on c 

14 color = "#RRCCBB" 

15 

16 # Fill a tiny rectangle with the specified color 

17 canvas.create_rectangle(x * 100 + 200, y * 100 + 200, 

18 X * 100 + 200 + 5, y * 100 +200+5, fill = color) 

19 y += 0.05 

20 X += 0.05 

21 

22 # Return the iteration count 

23 def count(c): 

24 z = complex(0, 0) # zO 

25 

26 for i in range(C0UNT_LIMIT): 

27 z = z * z + c # Get zl, z2, ... 

28 if abs(z) > 2: return i # The sequence is unbounded 

29 

30 return C0UNT_LIMIT # Indicate a bounded sequence 




(b) 


Figure 12.26 A Mandelbrot image is shown in (a) and a Julia set image is shown in (b). 


The count (c) function (lines 23-28) computes zi, Zz, • ■ ■ , Zeo- If none of their 
absolute values exceeds 2, we assume c is in the Mandelbrot set. Of course, 
there could always be an error, but 60 (C0UNT_LIMIT) iterations usually are 
enough. Once we find that the sequence is unbounded, the method returns the 
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iteration count (line 28). The method returns COUNT_LIMIT if the sequence is 
bounded (line 30). 

The loop in lines 6-20 examines each point {x, y) for — 2 < x < 2 and 
-2 < y < 2 with interval 0.01 to see if its corresponding complex number 
c = X + yi is in the Mandelbrot set (line 9). If so, paint the point red (line 11). 
If not, set a color that is dependent on its iteration count (line 14). Note that the 
point is painted in a square with width 5 and height 5. All the points are scaled 
and mapped to a grid of 400 X 400 pixels (lines 17-18). 

Complete the program to draw a Mandelbrot image, as shown in Figure 12.26a. 
** 12.15 (Tkinter: Julia set) The preceding exercise describes Mandelbrot sets. The Man¬ 
delbrot set consists of the complex c value such that the sequence z^+i = + c 

is bounded with zq fixed and c varying. If we fix c and vary zo{= x + yi), the 
point (x, y) is said to be in a Julia set for a fixed complex value c if the function 
Z-n+i “ + c stays bounded. Write a program that draws a Julia set as shown 

in Figure 12.26b. Note that you only need to revise the count method in Exer¬ 
cise 12.14 by using a fixed c value (—0.3 + 0.6/). 

*12.16 (Implement Stack using inheritance) In Listing 12.13, the Stack class is 
implemented using composition. Define a new Stack class using inheritance 
that extends list. 

Draw UML diagrams of the new class. Implement it. Write a test program that 
prompts the user to enter five strings and displays them in reverse order. 

*** 12.17 (Tkinter: the 24-point card game) Enhance Exercise 10.37 to enable the com¬ 
puter to display the expression for a 24-point game solution if one exists, as 
shown in Eigure 12.27. Otherwise, report that the solution does not exist. 



Figure 12.27 The program can automatically find a solution if one exists. 


** 12.18 (Tkinter: the BarChart class) Develop a class named BarChart that extends 
Canvas for displaying a bar chart: 

BarChartCparent, data, width = 400, height = 300) 

Where data is a list, each element in the list is a nested list that consists of a 
value, a title for the value, and a color for the bar in the bar chart. For example, 

for data = [[40, "CS", "red"], [30, "IS" "blue"], [50, "IT", 
"yel 1 ow"] ] , the bar chart is as shown in the left part of Figure 12.28. For data 
= [[140, "Freshman", "red"], [130, "Sophomore", "blue"], 

[150, "Junior", "yellow"], [80, "Senior", "green"]], the bar 

chart is as shown in the right part of Figure 12.28. Write a test program that dis¬ 
plays two bar charts, as shown in Figure 12.28. 

**I2.I9 (Tkinter: the PieChart class) Develop a class named PieChart that extends 
Canvas for displaying a pie chart using the following constructor: 

PieChartfparent, data, width = 400, height = 300) 
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Figure 12.28 The program uses the BarChart class to display bar charts. 

Where data is a list, each element in the list is a nested list that consists of a 
value, a title for the value, and a color for the wedge in the pie chart. For exam¬ 
ple, for data = [[40, "CS", "red"], [30, "IS", "blue"], [50, 
"IT", "yellow"]], the pie chart is as shown in the left part of Figure 12.29. 
For data = [[140, "Freshman", "red"], [130, "Sophomore", 

"blue"], [150, "lunior", "yellow"], [80, "Senior", 
"green"]], the pie chart is as shown in the right part of Figure 12.29. Write a 
test program that displays two pie charts, as shown in Figure 12.29. 



Figure 12.29 The program uses the PieChart class to display pie charts. 

**12.20 (Tkinter: The RegularPolygonCanvas Class) Define a subclass of Canvas, 
named Regul arPol ygonCanvas, to paint an n-sided regular polygon. The class 
contains a property named numberOfSides, which specifies the number of sides 
in the polygon. The polygon is centered in the canvas, and the polygon’s size is 
proportional to the size of the canvas. Create a triangle, square, pentagon, hexa¬ 
gon, heptagon, and octagon from RegularPolygonCanvas and display them, as 
shown in Figure 12.30. 



Figure 12.30 The program displays several n-sided polygons. 
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*12.21 (Tkinter: display an n-sided regular polygon) In Exercise 12.20 you created the 
Regu1arPo1ygonCanvas subclass for displaying an n-sided regular polygon. 
Write a program that displays a regular polygon and uses two buttons named -I- 1 
and —1 to increase or decrease the size of the polygon, as shown in Figure 
12.31a-b. Also enable the user to increase or decrease the size by clicking the 
right or left mouse button and by pressing the UP and DOWN arrow keys. 




Figure 12.31 (a-b) Clicking the -f 1 or — 1 button increases or decreases the number of sides of a regular polygon, 

(c-d) The program enables the user to click a cell to flip a coin. 


* 12.22 {Flip coins) Write a program that displays heads (H) or tails (T) for each of nine 
coins, as shown in Figure 12.3Ic-d. When a cell is clicked, the coin is flipped. 
Write a custom cell class that extends Label . In the initializer of the class, bind 
the event <Button-l> with the method for flipping the coin. When the program 
starts, all cells initially display H. 




























CHAPTER 


13 

Files and Exception 
Handling 

objectives 

■ To open a file using the open function for reading and writing data 
(§13.2.1). 

■ To write data to a file using the write method in a file object (§13.2.2). 

■ To test the existence of a file using the os. path. i sf i 1 e function (§13.2.3). 

■ To read data from a file using the read, read1 i ne, and read1 i nes meth¬ 
ods in a file object (§§13.2.4-13.2.5). 

■ To append data to a file by opening the file in the append mode (§13.2.6). 

■ To read and write numeric data (§13.2.7). 

■ To display open and save file dialogs for getting file names for reading and 
writing data (§13.3). 

■ To develop applications with files (§13.4). 

■ To read data from a Web resource (§13.5). 

■ To handle exceptions by using the try, except, and finally clauses 
(§13.6). 

■ To raise exceptions by using the raise statements (§13.7). 

■ To become familiar with Python’s built-in exception classes (§13.8). 

■ To access an exception object in the handler (§13.8). 

■ To define custom exception classes (§13.9). 

■ To perform binary 10 using the load and dump functions in the pickle 
module (§13.10). 

■ To create an address book using binary 10 (§13.11). 
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13.1 Introduction 

You can use a file to store data permanently; you can use exception handling to make 
your programs reliable and robust. 

why files? 

Data used in a program is temporary; unless the data is specifically saved, it is lost when the pro¬ 
gram terminates. To permanently store the data created in a program, you need to save it in a file 
on a disk or some other permanent storage device. The file can be transported and can be read 
later by other programs. In this chapter, you learn how to read and write data from and to a file. 

What happens if your program tries to read data from a file but the file does not exist? Your 
program will be abruptly terminated. In this chapter you will learn how to write the program 

why exception handling? 

to handle this exception so the program can continue to execute. 

^/Key 
/ Point 

13.2 Text Input and Output 

To read and write data from or to a file, use the open function to create a file object 
and use the object’s read and write methods to read and write data. 

absolute filename 

A file is placed in a directory in the file system. An absolute filename contains a filename with 
its complete path and drive letter. For example, c:\pybook\Scores.txt is the absolute filename 
for the file Scores.txt on the Windows operating system. Here, c:\pybook is referred to as the 

directory path 

directory path to the file. Absolute filenames are machine dependent. On the UNIX platform, 
the absolute filename may be /home/liang/pybook/Scores.txt, where /bome/liang/pybook is 
the directory path to the file Scores.txt. 

relative filename 

A relative filename is relative to its current working directory. The complete directory path 
for a relative file name is omitted. For example, Scores.py is a relative filename. If its current 
working directory is c:\pybook, the absolute filename would be c:\pybook\Scores.py. 

Files can be classified into text or binary files. A file that can be processed (that is, read. 

text file 

binary file 

created, or modified) using a text editor such as Notepad on Windows or vi on UNIX is called 
a text file. All the other files are called binary files. For example. Python source programs are 
stored in text files and can be processed by a text editor, but Microsoft Word files are stored in 
binary files and are processed by the Microsoft Word program. 

Although it is not technically precise and correct, you can envision a text file as consisting 
of a sequence of characters and a binary file as consisting of a sequence of bits. Characters in 
a text file are encoded using a character encoding scheme such as ASCII and Unicode. For 
example, the decimal integer 199 is stored as the sequence of the three characters 1, 9, and 9, 

why binary file? 

in a text file, and the same integer is stored as a byte-type value C7 in a binary file, because 
decimal 199 equals hex C7 (199 = 12 X 16^ + 7). The advantage of binary files is that they 
are more efficient to process than text files. 

Note 

Computers do not differentiate between binary files and text files. All files are stored in 
binary format, and thus all files are essentially binary files. Text lO (input and output) is 
built upon binary 10 to provide a level of abstraction for character encoding and decoding. 

This section shows you how to read and write strings from and to a text file. Binary files 
are introduced in Section 13.10. 

13.2.1 Opening a File 

How do you write data to a file and read the data back from a file? You need to first create a 
file object that is associated with a physical file. This is called opening a file. The syntax for 
opening a file is: 

fileVariable = openQfilename, modej 

The open function returns a file object for filename. The mode parameter is a string that 
specifies how the file will be used (for reading or writing), as shown in Table 13.1. 


13.2 Text Input and Output 441 


Table 13.1 File Modes 

Mode Description 

"r" Opens a file for reading. 

"w" Opens a new file for writing. If the file already exists, its 
old contents are destroyed. 

"a" Opens a file for appending data from the end of the file. 

" rb" Opens a file for reading binary data. 

"wb" Opens a file for writing binary data. 


For example, the following statement opens a file named Scores.txt in the current direc¬ 
tory for reading: 

input = open ("Scores.txt" , "r") 

You can also use the absolute filename to open the file in Windows, as follows: 

input = open (r "c:\pybook\Scores.txt", "r") 

The statement opens the file Scores.txt that is in the c:\pybook directory for reading. The 
r prefix before the absolute filename specifies that the string is a raw string, which causes the raw string 
Python interpreter to treat backslash characters as literal backslashes. Without the r prefix, 
you would have to write the statement using an escape sequence as: 

input = open ("c:\\pybook\\Scores.txt" , "r") 


13.2.2 Writing Data 

The open function creates a file object, which is an instance of the _io.TextIOWrapper 
class. This class contains the methods for reading and writing data and for closing the file, as 
shown in Figure 13.1. 


Jo.TextIOWrapper 



read([number.int) : str 


Returns the specified number of characters from the file. If the 
argument is omitted, the entire remaining contents in the file 
are read. 

readlineC): str 


Returns the next line of the file as a string. 

readlinesC): list 


Returns a list of the remaining lines in the file. 

writefs: str): None 


Writes the string to the file. 

closeO : None 


Closes the file. 


Figure 13.1 A file object contains the methods for reading and writing data. 


After a file is opened for writing data, you can use the write method to write a string to 
the file. In Listing 13.1, the program writes three strings to the file Presidents.txt. 

Listing 13.1 WriteDemo.py 

1 def mai n () : 

2 # Open file for output 
outfile = open( "Presidents.txt", "w' ) 


3 


open file for writing 
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write data 


close file 


file pointer 


Figure 13.2 


4 

5 # Write data to the file 

6 outfiie.writeC Bill Clinton\n") 

7 outfi 1 e .wri teC'George Bush\n'') 

8 outfi 1e .wri teC'Barack Obama") 

9 

10 outfile.closeO # Close the output file 

11 

12 mainO # Call the main function 

The program opens a file named Presidents.txt using the w mode for writing data (line 3). 
If the file does not exist, the open function creates a new file. If the file already exists, the 
contents of the file will be overwritten with new data. You can now write data to the file. 

When a file is opened for writing or reading, a special marker called a file pointer is posi¬ 
tioned internally in the file. A read or write operation takes place at the pointer’s location. 
When a file is opened, the file pointer is set at the beginning of the file. When you read or 
write data to the file, the file pointer moves forward. 

The program invokes the write method on the file object to write three strings (lines 6-8). 
Figure 13.2 shows the position of the file pointer after each write. 


D 


Initial file pointer position 


file pointer 


Bill Clinton\n 


After outfile.writeC'Bill Clinton\n") 


file pointer 


Bill Clinton\nCeorge Bush\n 


After outfile.writeC'George Bush\n") 


file pointer 


Bill Clinton\nCeorge Bush\nBarack Obama 


After outfile.writeC'Barack Obama") 


file pointer 


Three strings are written to the file. 


The program closes the file to ensure that data is written to the file (line 10). After this pro¬ 
gram is executed, three names are written to the file. You can view the file in a text editor, as 
shown in Figure 13.3. 


Presidents - Notepad ^ 


File Edit Format View 

Help 

'^ill Clinton 


George Bush 


Barack Obama 

' 1 

4 I 1 


Figure 13.3 A file named Presidents.txt contains three names. 



















13.2 Text Input and Output 443 



Note 

When you invoke printCstr), the function automatically inserts the newline charac¬ 
ter \n after displaying the string. However, the write function does not automatically 
insert the newline character. You have to explicitly write the newline character to the file. 



Warning 

If you open an existing file for writing, the original contents of the file will be 
destroyed/overwritten with the new text. 


13.2.3 Testing a File’s Existence 

To prevent the data in an existing file from being erased by accident, you should test to see if 
the file exists before opening it for writing. The i sf i 1 e function in the os. path module can 
be used to determine whether a file exists. For example: 

import os.path 

if os.path.isfileC'Presidents.txt”) : 
print( 'Presidents.txt exists") 

Here isfile("Presidents. txt") returns True if the file Presidents.txt exists in the 
current directory. 


13.2.4 Reading Data 

After a file is opened for reading data, you can use the read method to read a specified number 
of characters or all characters from the file and return them as a string, the read! i ne() method 
to read the next line, and the read! ines() method to read all the lines into a list of strings. 

Suppose the file Presidents.txt contains the three lines shown in Figure 13.3. The program 
in Listing 13.2 reads the data from the file. 



VideoNote 

Process text file 


Listing 13.2 ReadDemo.py 


1 

def mainO : 


2 

# Open file for input 

open file for reading 

3 

infile = open( 'Presidents.txt" , "r' ) 


4 

printed) Using readf): ") 

read all data 

5 

printfinfile. readO ) 

close file 

6 

7 

infile.closed # Close the input file 


/ 

8 

# Open file for input 

open file for reading 

9 

infile = openC'Presidents.txt" , "r") 


10 

print("\n(2) Using read(number): ") 

read characters 

11 

si = infi 1 e.read(4) 


12 

print(sl) 

read characters 

13 

s2 = infi 1 e. read(lO) 

raw string 

14 

print(repr(s2) ) 


15 

16 

infile.closed # Close the input file 


17 

# Open file for input 


18 

infile = openC'Presidents.txt" , "r") 


19 

print("\n(3) Using readlineC): ") 

read a line 

20 

linel = infi 1 e. readl i ned 


21 

line2 = infi 1 e. readl i ned 


22 

line3 = infi 1 e. readl i ned 


23 

line4 = infi 1 e. readl i ned 


24 

print(repr(linel)) 


25 

print(repr(line2)) 


26 

print(repr(line3)) 


27 

print(repr(line4)) 


28 

infile.closed # Close the input file 
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read all lines 


29 



30 

# Open file for input 


31 

infile = openC'Presidents .txt" , ' 

"r") 

32 

print("\n(4) Using readlines(): ' 

") 

33 

pri nt(i nfi 1 e. readl inesO) 


34 

infile.closeO # Close the input 

fi 1 e 

35 



36 

mainO # Call the main function 



a 

(1) Using read(): 

Bill Clinton 

George Bush 

Barack Obama 



(2) Using read(number): 

Bill 

' Clinton\nC' 



(3) Using readlineO : 

'Bill Clinton\n' 

'George Bush\n' 

'Barack Obama' 

1 I 



(4) Using readlinesf): 

['Bill Clinton\n', 'George Bush\n', 

'Barack Obama'] 


using readO 
using read (number) 
repr function 


The program first opens the file Presidents.txt using the r mode for reading through the file 
object infile (line 3). Invoking the infile. readC) method reads all characters from the 
file and returns them as a string (line 5). The file is closed (line 6). 

The file is reopened for reading (line 9). The program uses the read (number) method to 
read the specified number of characters from the file. Invoking infil e. read(4) reads 4 
characters (line 11) and infile.read(lO) reads 10 characters (line 13). The repr(s) 
function returns a raw string for s, which causes the escape sequence to be displayed as liter¬ 
als, as shown in the output. 

Figure 13.4 shows the file pointer’s position after each read. 


Bill Clinton\nCeorge Bush\nBarack Obama 


Initial 


file pointer position 


file pointer 


After si = i nfi 1 e. read(4) 
si is 'Bill' 


file pointer 

After s2 = i nfi 1 e. read(lO) 
s2 is 'Clinton\nG' 

file pointer 

Figure 13.4 The file pointer moves forward as characters are read from the file. 


Bill Clinton\nCeorge Bush\nBarack Obama 


Bill Clinton\nCeorge Bush\nBarack Obama 


using readl i ne() 


The file is closed (line 15) and reopened for reading (line 18). The program uses the 
readlineO method to read a line (line 20). Invoking infile.readlineC) reads a line 
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that ends with \n. All characters in a line are read including the \n. When the file pointer is 
positioned at the end of the file, invoking read1 i neC) or read() returns an empty string ' ' . 
Figure 13.5 shows the file pointer’s position after each readline method is called. 


Bill Clinton\nCeorge Bush\nBarack Obama 


Initi al 


file pointer position 


file pointer 


Bill Clinton\nCeorge Bush\nBarack Obama 


After 
1 i nel 


linel = infi 1 e. readline() 
is 'Bill Clinton\n' 


file pointer 


After line2 = infi 1 e. readline() 
line2 is 'George Bush\n' 


file pointer 


Bill Clinton\nCeorge Bush\nBarack Obama 


Bill Clinton\nCeorge Bush\nBarack Obama 


After 
1 i ne3 


lines = infi 1 e. readline() 
is 'Barack Obama' 


file pointer 


After line4 = infi 1 e. readline() 
1ine4 is '' 

file pointer 

Figure 13.5 The readl ine() method reads a line. 


Bill Clinton\nCeorge Bush\nBarack Obama 


The file is closed (line 28) and reopened for reading (line 31). The program uses the 
readl i nes () method to read all lines and return a list of strings. Each string corresponds to 
a line in the file. 

13.2.5 Reading All Data from a File 

Programs often need to read all data from a file. Here are two common approaches to accom¬ 
plishing this task: 

1. Use the read() method to read all data from the file and return it as one string. 

2. Use the readl ines() method to read all data and return it as a list of strings. 

These two approaches are simple and appropriate for small files, hut what happens if the 
file is so large that its contents cannot he stored in the memory? You can write the following 
loop to read one line at a time, process it, and continue reading the next line until it reaches the 
end of the file: 

line = infi1e.readline() # Read a line 
while line != '' : 

# Process the line here ... 

# Read next line 

line = infi1e.readl ine() 

Note that when the program reaches the end of the file, readl i ne() returns ' ' . 


using readl i nesO 
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Python also lets you read all lines by using a for loop, as follows: 

for line in infile: 

# Process the line here ... 


This is much simpler than using a whil e loop. 

Listing 13.3 illustrates a program that copies data from a source file to a target file and 
counts the number of lines and characters in the file. 


input file 
output file 


check file existence 


open file for input 
open file for output 

initialize countLi nes and 
countChars 
read a line 

increase countLi nes 
increase countChars 
write a line 


close input file 
close output file 


Listing 13.3 CopyFile.py 

1 import os.path 

2 import sys 

3 

4 def mainO : 

5 # Prompt the user to enter filenames 

6 fl = inputC'Enter a source file; ).strip() 

7 f2 = inputC'Enter a target file; ).strip() 

8 

9 # Check if target file exists 

10 if os.path.isfi1e(f2) : 

11 print(f2 + " already exists") 

12 sys.exitO 

13 

14 # Open files for input and output 

15 infile = openffl, "r") 

16 outfile = open (f2, 

17 

18 # Copy from input file to output file 

19 countLines = countChars = 0 

20 for line in infile: 

21 countLines += 1 

22 countChars += len(line) 

23 outfile.write(line) 

24 printfcountLines, 'lines and'', countChars, "chars copied") 

25 

26 infile.closeO # Close the input file 

27 outfile.closeO # Close the output file 

28 

29 mainO # Call the main function 



Enter a source file: input.txt [|^enter| 
Enter a target file: outputl.txt Colter 
outputl.txt already exists 


Enter a source 
Enter a target 
3 lines and 73 


file: input.txt I —I Enter | 

file: output2.txt | 

characters copied 


The program prompts the user to enter a source file f 1 and a target file f 2 (lines 6-7) and 
determines whether f2 already exists (lines 10-12). If so, the program displays a message that 
the file already exists (line 11) and exits (line 12). If the file doesn’t already exist, the program 
opens file fl for input and f2 for output (lines 15-16). It then uses a for loop to read each 
line from file f 1 and write each line into file f 2 (lines 20-23). The program tracks the number 
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of lines and characters read from the file (lines 21-22). To ensure that the files are processed 
properly, you need to close the files after they are processed (lines 26-27). 

13.2.6 Appending Data 

You can use the a mode to open a file for appending data to the end of an existing file. Listing 
13.4 gives an example of appending two new lines into a file named Info.txt. 

Listing 13.4 AppendDemo.py 


open file for appending 
write data 
close file 

6 

7 mainO # Call the main function 

The program opens a file named Info.txt using the a mode for appending data to the file 
through the file object outfile (line 3). Assume the existing file contains the text “Program¬ 
ming is fun.” Figure 13.6 shows the position of the file pointer after the file is opened and after 
each write. When the file is opened, the file pointer is positioned at the end of the file. 


1 def mai n () : 

2 # Open file for appending data 

3 outfile = openC'Info.txt" , "a') 

4 outfi1e.write( '\nPython is interpreted\n”) 

5 outfile.closeO # Close the file 


Programming is fun 


Initial file pointer position when file 
is opened with mode "a" 


file pointer 


Programming is fun\nPython is interpreted\n 


File pointer position after 

outfi1e.write("\nPython is interpreted\n") 


file pointer 


Figure 13.6 The data is appended to the file. 


The program closes the file to ensure that the data is properly written to the file (line 5). 

13.2.7 Writing and Reading Numeric Data 

To write numbers to a file, you must first convert them into strings and then use the write 
method to write them to the file. In order to read the numbers back correctly, separate them 
with whitespace characters, such as or \n. 

In Listing 13.5, the program writes ten random single digits to a file and reads them back 
from the file. 

Listing 13.5 WriteReadNumbers.py 

1 from random import randint 

2 

3 def mainO : 

4 # Open file for writing data 

5 outfile = openC'Numbers.txt", "w' ) open file for writing 

6 for i in range(lO): 

7 outfile.writeCstrCrandintC*!, 9)) + ) 


write data 
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close file 

Files and 

8 

9 

10 

Exception Handling 

outfile.closeO # Close the file 

# Open file for reading data 

open file for reading 

11 

infile = openC 'Numbers. txt" , "r' ) 


12 

s = infile.read() 

convert to numbers 

13 

numbers = [eval(x) for x in s.spT 


14 

for number in numbers: 


15 

print(number, end = ") 

close file 

16 

infile.closeO # Close the file 


17 



18 mainO # Call the main function 



8141255132 


A 

W P( 


heck 

Point 


MyProgrammingLab" 


The program opens a file named Numbers.txt using the w mode for writing data to that 
file using the file object outfile (line 5). The for loop writes ten numbers into the file, 
separated by spaces (lines 6-7). Note that the numbers are converted to strings before being 
written to the file. 

The program closes the output file (line 8) and reopens it using the r mode for reading data 
through the file object infile (line 11). The readC) method reads all data as a string (line 
12). Since the numbers are separated by spaces, the string’s split method splits the string 
into a list (line 13). The numbers are obtained from the list and displayed (lines 14-15). 

13.1 How do you open a file for reading, for writing, and for appending, respectively? 

I 3.2 What is wrong about creating a file object using the following statement? 

infile = open ("c:\book\test.txt", "r") 

13.3 When you open a file for reading, what happens if the file does not exist? When you 
open a file for writing, what happens if the file already exists? 

I 3.4 How do you determine whether a file exists? 

I 3.5 What method do you use to read 30 characters from a file? 

I 3.6 What method do you use to read all data into a string? 

13.7 What method do you use to read a line? 

I 3.8 What method do you use to read all lines into a list? 

I 3.9 Will your program have a runtime error if you invoke readC) or read1 ine() at the 
end of the file? 

13.10 When reading data, how do you know if it is the end of the file? 

13.1 I What function do you use to write data to a file? 

13.12 How do you denote a raw string literal in the program? 

13.1 3 How do you write and read numeric data? 




13.3 File Dialogs 

The tkinter. filedialog module contains the functions askopenfi! ename and 
asksaveasf i 1 ename /or displaying the file Open and Save A.s dialog boxes. 


Tkinter provides the tki nter. f i 1 edi al og module with the following two functions: 


# Display a file dialog box for opening an existing file 
filename = askopenfi 1 ename() 
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# Display a file dialog box for specifying a file for saving data 
filename = asksaveasfilenamef) 

Both functions return a filename. If the dialog is cancelled by the user, the function returns 
None. Here is an example of using these two functions: 

1 from tkinter.fi1edialog import askopenfi1ename 

2 from tkinter.fi1edialog import asksaveasfi 1 ename 

3 

4 fi 1 enameforReadi ng = askopenfi 1 ename() file dialog for opening 

5 printC'You can read from " + fi1enameforReading) 

6 

7 fi 1 enameforWri ti ng = asksaveasfi 1 ename() file dialog for saving 

8 printC'You can write data to " + fi1enameforWriting) 

When you run this code, the askopenfi 1 ename () function displays the Open dialog box 
for specifying a file to open, as shown in Figure 13.7a. The asksaveasfi!enameC) func¬ 
tion displays the Save As dialog for specifying the name of the file to save, as shown in 
Figure 13.7b. 



(a) 



Figure 13.7 The askopenfi! ename () function displays the Open dialog (a) and the asksaveasfi! enameC) function 
displays the Save As dialog (b). 


Now let’s create a simple text editor that uses menus, toolbar buttons, and file dialogs, as 
shown in Figure 13.8. The editor enables the user to open and save text files. Listing 13.6 
shows the program. 

Listing 13.6 FileEditor.py 

1 from tkinter import * 

2 from tki nter. fi 1 edi al og import askopenfi 1 ename import file dialogs 

3 from tkinter.fi1edialog import asksaveasfi 1 ename 

4 

5 class FileEditor: 

6 def _init_(self): 

7 window = Tk() 

8 window. titleC'Simple Text Editor") 











































450 Chapter 13 Files and Exception Handling 



Four score ar.d sever, years ago our 
fathers brought forth on this 
continent, a new nation, 
conceived in Liberty, and dedicated to 
the proposition that all men are 
created equal. 

Now we are engaged in a great civil 
war, testing whether that nation, or 
any nation so 

conceived and dedicated, can long 
endure. We are met on a great 
battle-field of that war. 

We have come to dedicate a portion of 
that field, as a final resting place 
for those who here gave their 
lives that that nation might live. It 
is altogether fitting and proper that 
we should do this. 



Save 

.. w^...’e and seven years ago our 


fathers brought forth on this 
continent, a new nation, 
conceived in Liberty, and dedicated to 
the proposition that all m.en are 
created equal. 

Now we are engaged in a great civil 
war, testing whether that nation, or 
any nation so 

conceived and dedicated, can long 
endure. We are met on a great 
battle-field of that war. 

We have come to dedicate a portion of 
that field, as a final resting place 
for those who here gave their 
lives that that nation m.ight live. It 
is altogether fitting and proper that 
we should do this. 


Figure 13.8 The editor enables you to open and save files from the File menu or from the toolbar. 



9 

10 

# Create a menu bar 

menu bar 

11 

menubar = Menu(window) 


12 

window.config(menu = menubar) # Display the menu bar 


13 



14 

# Create a pull-down menu and add it to the menu bar 


15 

operationMenu = Menu(menubar, tearoff = 0) 

add menu 

16 

menubar.add_cascade(label = "File", menu = operationMenu) 


17 

operationMenu.add_command(label = "Open", 

open file handler 

18 

command = self.openFile ) 


19 

operationMenu.add_command(label = "Save", 

save file handler 

20 

command = self.saveFi1e ) 


21 



22 

23 

24 

25 

26 

# Add a tool bar frame 

frameO = Frame(window) # Create and add a frame to window 
frameO.grid(row = 1, column = 1, sticky = W) 


# Create images 


27 

openimage = PhotoImage(fi1e = "image/open.gif") 


28 

savelmage = PhotoImage(fi1e = "image/save.gif") 


29 


toolbar buttons 

30 

Button(frameO, image = openimage, command = 


31 

self.openFile).grid(row = 1, column = 1, sticky = W) 


32 

Button(frameO, image = savelmage. 


33 

command = self.saveFile).grid(row = 1, column = 2) 


34 



35 

framel = Frame(window) # Hold editor pane 


36 

framel.grid(row = 2, column = 1) 


37 


scrollbar 

38 

scrollbar = Scrol1bar(framel) 


39 

scrol1 bar.pack(side = RIGHT, fill = Y) 

text 

40 

self.text = Text(framel, width = 40, height = 20, 


41 

wrap = WORD, yscrol1 command = scrol1 bar.set) 


42 

self .text.packO 

handle scrolling 

43 

scrollbar.config(command = self.text.yview) 


44 
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45 window.mainloopO # Create an event loop 

46 

47 def openFl1e(self): 

48 fi1enameforReading = askopenfi1ename() 

49 inflle = open(filenameforReading, 'r") 

50 self.text.insert(END, inflle.read()) # Read all from the file 

51 infile.closed # Close the input file 

52 

53 def saveFi1e(self): 

54 fi1enameforWriting = asksaveasfi1enameO 

55 outfile = open (fil enameforWri ting, "w'') 

56 # Write to the file 

57 outfile.write(self.text. get(1.0, END)) 

58 outfile.closed # Close the output file 

59 

60 FileEditord # Create GUI 

The program creates the File menu (lines 15-20). The File menu contains the menu com¬ 
mands Open for loading a file (line 18) and Save for saving a file (line 20). When the Open 
menu is clicked, the openFile method (lines 47-51) is invoked to display the Open dialog to 
open a file using the askopenfi!ename function (line 48). After the user selects a file, the 
filename is returned and used to open the file for reading (line 49). The program reads the data 
from the file and inserts it into the Text widget (line 50). 

When the Save menu is clicked, the saveFi 1 e method (lines 53-58) is invoked to display 
the Save As dialog to save a file using the asksaveasfi! ename function (line 54). After the 
user enters or selects a file, the filename is returned and used to open the file for writing (line 
55). The program reads the data from the Text widget and writes it to the file (line 57). 

The program also creates toolbar buttons (lines 30-33) and places them in a frame. The 
toolbar buttons are the buttons with image icons. When the Open toolbar button is clicked, 
the callback method openFile is invoked (line 31). When the Save toolbar button is 
clicked, the callback method saveFi 1 e is invoked (line 33). 

The program creates a text area using the Text widget tied with a scroll bar (lines 38—43). 
The Text widget and scrollbar are placed inside f ramel. 

13.14 How do you display a file dialog for opening a file? 

13.15 How do you display a file dialog for saving a file? 

13.4 Case Study: Counting Each Letter in a File 

The problem in this case study is to write a program that prompts the user to enter a 
filename and counts the number of occurrences of each letter in the file regardless of case. 

Here are the steps to solve this problem: 

1. Read each line from the file as a string. 

2. Use the string’s lower () method to convert all the uppercase letters in the string to 
lowercase. 

3. Create a list named counts that has 26 int values, each of which counts the occur¬ 
rences of a letter. That is, counts [0] counts the number of times a appears, 
counts [1] counts the number of bs, and so on. 

4. For each character in the string, determine whether it is a lowercase letter. If so, incre¬ 
ment the corresponding count in the list. 

5. Finally, display the count. 


open file 


save file 


create GUI 


iraeck 
W Point 

MyProgrammingLab" 

c/Key 
^ ) Point 


Listing 13.7 shows the complete program. 
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Listing 13.7 CountEachLetter.py 



1 

def mainO : 

enter a filename 

2 

filename = input("Enter a filename: ').strip() 

open file 

3 

A 

infile = open(filename, "r") # Open the file 

create a list 

5 

counts = 26 * [0] # Create and initialize counts 

read a line 

6 

for line in infile: 

count letters in line 

7 

8 

# Invoke the countLetters function to count 
countLetters(line.lower(), counts) 


9 

10 

# Display results 


11 

for i in range(len(counts)): 

display results 

12 

if counts[i] != 0: 


13 

print(chr(ord('a') + i) + " appears + 


14 

+ (" time" if countsfi] == 1 else " 


15 



16 

infile.closeO # Close file 


17 



18 

# Count each letter in the string 

count letters 

19 

def countLetters(line, counts): 

count a letter 

20 

for ch in line: 


21 

if ch.isalphaO : 


22 

counts[ord(ch) - ord('a')] += 1 


23 



24 

mainO # Call the main function 


each letter 


str(counts[i]) 

times")) 


Enter a filename: input.txt [ -j Enter 
a appears 3 times 
b appears 3 times 
X appears 1 time 


The main function prompts the user to enter a filename (line 2) and opens the file (line 3). 
It creates a list with 26 elements initialized to (line 5). The for loop (lines 6-8) reads each 
line from the file, converts the letters to lowercase, and passes them to invoke 

countLetters. 

The countLetters (1 ine, counts) function examines each character in line. If it is 
a lowercase letter, the program adds 1 to its corresponding counts (lines 21-22). 

After all the lines are processed, the program displays each letter contained in the file and 
its count, if the count is greater than 0 (lines 11-14). 

13.5 Retrieving Data from the Web 

^Key open function to open a Uniform Resource Locator (URL) and 

IT' " Point read data from the Web. 

Using Python, you can write simple code to read data from a Web site. All you need to do is 
to open a URL by using the urlopen function, as follows: 

infile = urllib.request. urlopen("http://www. yahoo.com") 

The urlopen function (defined in the url 1 ib. request module) opens a URL resource 
like a file. Here is an example that reads and displays the Web content for a given URL: 


import urllib.request 
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1 nf 1 le = urllib.request.u rlopen ("http://www.yahoo.cotn/index.html ") 
printCinfi 1 e. read() .decodeO) 


The data read from the URL using infile. readC) is raw data in bytes. Invoking the 
decode () method converts the raw data to a string. 

Let’s rewrite the program in Listing 13.7 to prompt the user to enter a file from a URL on 
the Internet rather than from a local system. The program is given in Listing 13.8. 


Listing 13.8 CountEachLetterURL.py 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 


import url1ib.request 
def mai n() : 

url = i nputC'Enter a URL for a file; ).strip() 
infile = urllib.request.urlopen(url) 

s = infile. readO .decodeO # Read the content as string 

counts = countLetters(s.lower()) 

# Display results 
for i in range(len(counts)) : 
if counts[i] != 0: 

print(chr(ord('a') + i) + " appears " + str(counts[i]) 
+ (’ time" if countsfi] == 1 else " times")) 

# Count each letter in the string 
def countLetters(s) : 

counts = 26 * [0] # Create and initialize counts 
for ch in s: 

if ch.isalpha(): 

counts[ord(ch) - ord(’a')] += 1 
return counts 

mainO # Call the main function 


enter a URL 
open a URL 
read data from URL 

count letters in line 


display results 


count letters 


count a letter 


Enter a filename: http://cs.armstrong.edu/liang/data/Lincoln.txt 
a appears 102 times 

14 times 
31 times 
58 times 
165 times 

27 times 

28 times 
80 times 
68 times 
3 times 
42 times 
13 times 
77 times 
92 times 

15 times 
1 time 


appears 

appears 

appears 

appears 

appears 

appears 

appears 

appears 

appears 

appears 

appears 

appears 

appears 

appears 

appears 

appears 

appears 

appears 

appears 

appears 

appears 

appears 


79 times 
43 times 
126 times 
21 times 
24 times 
28 times 
10 times 
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The main function prompts the user to enter a URL (line 4), opens the URL (line 5), and 
reads data from the URL into a string (line 6). The program converts the string to lowercase 
and invokes the countLetters function to count the occurrences of each letter in the string 
(line 8). The function returns a list showing how many times each letter occurs. 

The countLetters(s) function creates a list of 26 elements with an initial value of 0 
(line 18). The function examines each character in s. If it is a lowercase letter, the program 
adds 1 to its corresponding counts (lines 20-21). 



Note 

The http:// prefix is required in the URL for the uriopen function to recognize a 
valid URL. It would be wrong if you enter a URL like this: 


cs.armstrong.edu/Iiang/data/Lincoln.txt 


/Check 
{. Point 

MyProgrammingLab' 


C ? Point 


13.16 How do you open a Web page from a Python program? 

13.17 What function can be used to return a raw string from a normal string? 

13.6 Exception Handling 

Exception handling enables a program to deal with exceptions and continue its 
normal execution. 


why exception handling? 



VideoNote 

Handle exceptions 



When running the programs in the preceding sections, what happens if the user enters a file or a 
URL that does not exist? The program would be aborted and raise an error. For example, if you try 
to run Listing 13.7 by entering a nonexistent filename, the program would report this lOError: 


c:\pybook\python CountEachLetter.py 

Enter a filename: NonexistentOrIncorrectFiIe.txt 

Traceback (most recent call last): 

File "C:\pybook\CountEachLetter.py", line 23, in <module> 
mai n() 

File "C:\pybook\CountEachLetter.py", line 4, in main 
infile = open(filename, "r") # Open the file 
lOError: [Errno 22] Invalid argument: 'NonexistentOrIncorrectFile.txt\r' 


traceback 


try ... except 


The lengthy error message is called a stack traceback or traceback. The traceback gives 
information on the statement that caused the error by tracing back to the function calls that led 
to this statement. The line numbers of the function calls are displayed in the error message for 
tracing the errors. 

An error that occurs at runtime is also called an exception. How can you deal with an 
exception so that the program can catch the error and prompt the user to enter a correct file¬ 
name? This can be done using Python’s exception handling syntax. 

The syntax for exception handling is to wrap the code that might raise (or throw) an excep¬ 
tion in a try clause, as follows: 

try: 

<body> 

except <ExceptionType>: 

<handler> 

Here, <body> contains the code that may raise an exception. When an exception occurs, 
the rest of the code in <body> is skipped. If the exception matches an exception type, the cor¬ 
responding handler is executed. <handl er> is the code that processes the exception. Now 
you can insert new code for exception handling into lines 2 and 3 in Listing 13.7 to let the user 
enter a new filename if the input is incorrect, as shown in Listing 13.9. 
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Listing 13.9 CountEachLetterWithExceptionHandling.py 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 
29 


def mai n () : 

while True: 
try: 

filename = inputC'Enter a filename: ").strip() 
infile = open(filename, 'r") # Open the file 

break 


if an exception occurs 


except lOError: 
pri ntC'File 


+ filename + " does not exist. Try again") 


counts = 26 * [0] # Create and initialize counts 
for line in infile: 

# Invoke the countLetters function to count each letter 
countLetters(line.lower(), counts) 


# Display results 
for i in range(len(counts)): 
if counts[i] != 0: 

print(chr(ord('a') + i) + " appears " + str(counts[i]) 
+ (" time" if counts[i] == 1 else ’ times")) 

infile.closeO # Close file 


# Count each letter in the string 
def countLetters(line, counts): 
for ch in line: 

if ch.isalphaO : 

counts[ord(ch) - ord('a')] += 1 


main() 


Enter a filename: NonexistentOrIncorrectFi1e I -I Ente^ 

File NonexiStentOrIncorrectFi1e does not exist. Try again 

Enter a filename: Lincoln.dat ^.-1 EnteTj 

File Lincoln.dat does not exist. Try again 

Enter a filename: Lincoln.txt [ —I Enter j 

a appears 102 times 

b appears 14 times 


w appears 28 times 
y appears 10 times 


The program uses a while loop to repeatedly prompt the user to enter a filename (lines 
2-8). If the name is correct, the program exits the loop (line 6). If an lOError exception is 
raised by invoking the open function (line 5), the except clause is executed to process the 
exception (lines 7-8) and the loop continues. 

The try/except block works as follows: 

■ First, the statements in the body between try and except are executed. 

■ If no exception occurs, the except clause is skipped. In this case, the break state¬ 
ment is executed to exit the while loop. 


try clause 
enter a filename 
open file 

create a list 
read a line 

count letters in line 

display results 

count letters 

count a letter 


try ... except 
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■ If an exception occurs during execution of the try clause, the rest of the clause is 
skipped. In this case, if the file does not exist, the open function raises an exception 
and the break statement is skipped. 

■ When an exception occurs, if the exception type matches the exception name after 
the except keyword, the except clause is executed, and then the execution contin¬ 
ues after the try statement. 

■ If an exception occurs and it does not match the exception name in the except 
clause, the exception is passed on to the caller of this function; if no handler is found, 
it is an unhandled exception and execution stops with an error message displayed. 

A try statement can have more than one except clause to handle different exceptions. 

The statement can also have an optional el se and/or f i nal 1 y statement, in a syntax like this: 

1 try: 

2 <body> 

3 except <ExceptionTypel>: 

4 <handlerl> 

5 ... 

6 except <ExceptionTypeN>: 

7 <handlerN> 

8 except : 

9 <handlerExcept> 

10 else: 

11 <process_else> 

12 finally: 

13 <process_fi nal 1 y> 

multiple excepts 


el se 

ft nal 1 y clause 


The multiple excepts are similar to el i fs. When an exception occurs, it is checked to 
match an exception in an except clause after the try clause sequentially. If a match is found, 
the handler for the matching case is executed and the rest of the except clauses are skipped. 
Note that the <ExceptionType> in the last except clause may he omitted. If the exception 
does not match any of the exception types before the last except clause (line 8), the 
<handl erExcept> (line 9) for the last except clause is executed. 

A try statement may have an optional el se clause, which is executed if no exception is 
raised in the try body. 

A try statement may have an optional f i nal 1 y clause, which is intended to define clean¬ 
up actions that must be performed under all circumstances. Listing 13.10 gives an example of 
using exception handling. 


Listing 13.10 TestExcepti on. py 


enter two numbers 

except ZeroDivisionError 
except SyntaxError 
except 
el se 
ft nally 


1 def mainO : 

2 try: 

3 numberl, number2 = eval ( 

4 inputC'Enter two numbers, separated by a comma: ")) 

5 result = numberl / number2 

6 printC'Result is", result) 

7 except ZeroDivisionError: 

8 pri ntC'Division by zero!") 

9 except SyntaxError: 

10 printC'A comma may be missing in the input") 

11 except : 

12 pri ntC'Something wrong in the input") 

13 else: 

14 printC'No exceptions") 

15 finally: 
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16 printC'The finally clause is executed") 

17 

18 mainO # Call the main function 










When you enter 3, 4, the program computes the division and displays the result, then the 
el se clause is executed, and finally the f i nal 1 y clause is executed. 

When you enter 2 , 0, a ZeroDi vi sionEr ror is raised when executing the division (line 
5). The except clause in line 7 caught this exception and processed it, and the f i nal 1 y 
clause is then executed. 

When you enter 2 3, a SyntaxError is raised. The except clause in line 9 caught this 
exception and processed it, and the f i nal 1 y clause is then executed. 

When you enter a, v, an exception is raised. This exception is processed by the except 
clause in line 11, and the f i nal 1 y clause is then executed. 

13.7 Raising Exceptions 

Exceptions are wrapped in objects, and objects are created from classes. An exception 
is raised from a function. 

You learned how to write the code to handle exceptions in the preceding section. Where does 
an exception come from? How is an exception created? The information pertaining to an 
exception is wrapped in an object. An exception is raised from a function. When a function 
detects an error, it creates an object from an appropriate exception class and throws the excep¬ 
tion to the caller of the function, using the following syntax: 

raise ExceptionClass("Something is wrong") 

Here’s how this works. Suppose the program detects that an argument passed to a function 
violates the function’s contract; for example, the argument must be nonnegative, but a nega¬ 
tive argument is passed. The program can create an instance of RuntimeError and raise the 
exception, as follows: 

ex = Runti meErrorC'Wrong argument") 
raise ex 


tr/Key 

Sr (Point 


Enter two numbers, separated by a comma: a, v [ Enter | 
Something wrong in the input 
The finally clause is executed 


Enter two numbers, separated by a comma: 2 3 [ ^ Enter | 

A comma may be missing in the input 
The finally clause is executed 


Enter two numbers, separated by a comma: 2, 0 I ^ Enter 
Division by zero! 

The finally clause is executed 


Enter two numbers. 

separated by a comma: 3, 4 [j^Enter] 

Result is 0.75 


No exceptions 


The finally clause 

is executed 
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import Ceomet ri cOb j ect 

extend Ceometri cObject 

initialize radius 

raise exception 
set radius 


create a circle 

handle exception 


Or, if you prefer, you can combine the preceding two statements in one like this: 

raise RuntimeErrorC'Wrong argument") 

You can now modify the setRadi us method in the Ci rcl e class in Listing 12.2 to raise a 
RuntimeError exception if the radius is negative. The revised Circle class is given in 
Listing 13.11. 

Listing 13.11 Ci rcleWithException.py 

1 from CeometricObject import GeometricObject 

2 import math 

3 

4 class Circle(GeometricObject): 

5 def _ _init (self, radius): 

6 superC). init () 

7 self.setRadius(radius) 

8 

9 def getRadius(self): 


10 


return self._radius 

11 



12 

def 

setRadius(self, radius): 

13 


if radius < 0: 

14 


raise RuntimeError ('Negative radius') 

15 


el se : 

16 


self._radius = radius 

17 



18 

def 

getArea(self): 

19 


return self._radius * self._radius * math.pi 

20 



21 

def 

getOiameter(self): 

22 


return 2 * self._radius 

23 



24 

def 

getPerimeter(self): 

25 


return 2 * self._radius * math.pi 

26 



27 

def 

pri ntCi rcl e(sel f) : 

28 


print(self._str_() + " radius: " + str(self. 


The test program in Listing 13.12 creates circle objects using the new Circle class in 
Listing 13.11. 

Listing 13.12 TestCi rcleWithException.py 

1 from CircleWithException import Circle 

2 

3 try: 

4 cl = Ci rcl e(5) 

5 printC'cl's area is", cl.getAreaO) 

6 c2 = Ci rcl e(-5) 

7 print("c2's area is" , c2 .getAreaO) 

8 c3 = Circle(O) 

9 print("c3's area is", c3.getAreaO) 

10 except RuntimeException: 

11 pri ntC'Inval id radius") 


cl's area is 78.53981633974483 
Invalid radius 
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When attempting to create a Ci rcl e object with a negative radius (line 6), a Runti meEr ror 
is raised. The exception is caught in the except clause in lines 10-11. 

Now you know how to raise exceptions and how to handle exceptions. So what are the 
benefits of using exception handling? It enables a function to throw an exception to its caller, exception handling benefits 
The caller can handle this exception. Without this capability, the called function itself must 
handle the exception or terminate the program. Often the called function does not know what 
to do in case of an error. This is typically the case for library functions. The library function 
can detect the error, but only the caller knows what needs to be done when an error occurs. 

The essential benefit of exception handling is to separate the detection of an error (done in a 
called function) from the handling of an error (done in the calling method). 

Many library functions raise exceptions, such as ZeroDivisionError, TypeError, 
and IndexError. You can use the try-except syntax to catch and process the 
exceptions. 

Functions may invoke other functions in a chain of function calls. Consider an example 
involving multiple function calls. Suppose the main function invokes functionl, 
functionl invokes functionZ, functionZ invokes functions, and functions raises 
an exception, as shown in Figure 13.9. Consider the following scenario: 

■ If the exception type is Exceptions, it is caught by the except block for handling 
this exception in functionZ. statements is skipped, and statements is 
executed. 

■ If the exception type is ExceptionZ, functionZ is aborted, the control is 
returned to functionl, and the exception is caught by the except block for 
handling ExceptionZ in functionl. statements is skipped, and statement4 
is executed. 

■ If the exception type is Exception!, functionl is aborted, the control is 
returned to the main function, and the exception is caught by the except block for 
handling Exceptionl in the main function, statementl is skipped, and 

statementZ is executed. 

■ If the exception is not caught in functionZ, functionl, or main, the program 
terminates, and statementl and statementZ are not executed. 



An exception 
is thrown in 
functions 


Call Stack 








function3 





function2 


function2 



functionl 


functionl 


functionl 

main function 


main function 


main function 


main function 


Figure 13.9 If an exception is not caught in the current function, it is passed to its caller. The process is repeated until 
the exception is caught or passed to the main function. 
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13.8 Processing Exceptions Using Exception Objects 

You can access an exception object in the except clause. 

As stated earlier, an exception is wrapped in an object. To throw an exception, you first create 
an exception object and then use the ran se keyword to throw it. Can this exception object be 
accessed from the except clause? Yes. You can use the following syntax to assign the excep¬ 
tion object to a variable: 


try 

<body> 

except Except!onType as ex: 
<handler> 


read a number 
catch exception 


With this syntax, when the except clause catches the exception, the exception object is 
assigned to a variable named ex. You can now use the object in the handler. 

Listing 13.13 gives an example that prompts the user to enter a number and displays the 
number if the input is correct. Otherwise, the program displays an error message. 

Listing 13.13 ProcessExceptionObject .py 

1 try: 

2 number = eval(i nput("Enter a number: ")) 

3 printC'The number entered is", number) 

4 except NameError as ex : 

5 printC'Exception : " , ex) 


Enter a number: 34 EnaT] 
The number entered is 34 



Enter a number: one 

Exception: name 'one' is not defined 


When you enter a nonnumeric value, an object of NameError is thrown from line 2. This 
object is assigned to variable ex. So, you can access it to handle the exception. The 

_str_C) method in ex is invoked to return a string that describes the exception. In this 

case the string is name 'one' is not defined. 


13.9 Defining Custom Exception Classes 

^Key define a custom exception class by extending BaseException or a subclass 

Point o/ BaseException. 

So far we have used Python’s built-in exception classes such as ZeroDivisionError, 
SyntaxError, RuntimeError, and NameError in this chapter. Are there any other types 
of exceptions you can use? Yes, Python has many more built-in exceptions. Figure 13.10 
shows some of them. 

Note 

The class names Exception, StandardError, and RuntimeError are somewhat 
confusing. All three of these classes are exceptions, and all of the errors occur at runtime. 

The BaseException class is the root of exception classes. All Python exception classes 
inherit directly or indirectly from BaseException. As you can see. Python provides quite a 
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BaseException 

Exception 

f 

StandardError 


Ari thmeti cError 

EnvironmentError 

RuntimeError | 

LookupError 

SyntaxError 


t 


t 


ZeroDivisionError | 




IndentationError | 







lOError OSError IndexError KeyError 


Figure 13.10 Exceptions raised are instances of the classes shown in this diagram, or of subclasses of one of these 
classes. 


few exception classes. You can also define your own exception classes, derived from 
BaseException or from a subclass of BaseException, such as RuntimeError. 

The setRadius method in the Circle class in Listing 13.11 throws a RuntimeError 
exception if the radius is negative. The caller can catch this exception, but the caller does not 
know what radius caused this exception. To fix this problem, you can define a custom excep¬ 
tion class to store the radius, as shown in Listing 13.14. 

Listing 13.14 InvalidRadiusException.py 

1 class InvalidRadiusException(RuntimeError) : extend RuntimeError 

2 def _init_(self, radius): 

3 super(). init () 

4 self.radius = radius 

This custom exception class extends RuntimeError (line 1). The initializer simply 
invokes the superclass’s initializer (line 3) and sets the radius in the data field (line 4). 

Now let’s modify the setRadius(radius) method in the Circle class to raise an 
Inval idRadiusException if the radius is negative, as shown in Listing 13.15. 

Listing 13.15 Ci rcleWithCustomException.py 

1 from CeometricObject import GeometricObject 

2 from InvalidRadiusException import InvalidRadiusException 

3 import math 

4 

5 class Circle(GeometricObject): 

6 def _init_(self, radius): 

7 super()._init_() 

8 self.setRadius(radius) 

9 

10 def getRadius(self): 

11 return self._radius 

12 

13 def setRadius(self, radius): 


import Ceomet ri cOb j ect 
import 

InvalidRadiusException 
extend CeometricObject 

initialize radius 

setRadius 
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get radius 




order of exception handlers 


14 


if radius >= 0: 

15 


self._radius = radius 

16 


el se : 

17 


raise InvalidRadiusException(radius) 

18 



19 

def 

getArea(self): 

20 


return self._radius * self._radius * math.| 

21 



22 

def 

getDiameter(self): 

23 


return 2 * self._radius 

24 



25 

def 

getPerimeter(self): 

26 


return 2 * self._radius * math.pi 

27 



28 

def 

pri ntCi rcl e(sel f) : 

29 


print(self._str_() , "radius:'", self._radi 


The setRadius method raises an Inva1 idRadlusException if the radius is negative 
(line 17). Listing 13.16 gives a test program that creates circle objects using the new Ci rcl e 
class in Listing 13.15. 

Listing 13.16 TestCi rcleWithCustomException.py 

1 from CircleWithCustomException import Circle 

2 from InvalidRadiusException import InvalidRadiusException 

3 

4 try: 

5 cl = Ci rcle(5) 

6 printC'cl's area is", cl.getAreaO) 

7 c2 = Ci rcl e(-5) 

8 print("c2's area is", c2 . getAreaO) 

9 c3 = Ci rcl e(0) 

10 print("c3's area is", c3.getAreaO) 

11 except Inval i dRadiusException as ex: 

12 printC'The radius", ex.radius, "is invalid") 

13 except Exception: 

14 pri ntC'Something is wrong") 


cl's area is 78.53981633974483 
The radius -5 is invalid 


When creating a Circle object with a negative radius (line 7), an 
Inval idRadiusException is raised. The exception is caught in the except clause in 
lines 11-12. 

The order in which exceptions are specified in except blocks is important, because 
Python finds a handler in this order. If an except block for a superclass type appears before 
an except block for a subclass type, the except block for the subclass type will never be 
executed. Thus, it would be wrong to write the code as follows: 

try: 

except Exception: 

pri ntC'Something is wrong") 

except InvalidRadiusException: 
pri ntC'Inval id radius") 
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13.18 Suppose that statementZ causes an exception in the following try-except 


block: 


MyProgrammingLab" 


try: 


statementl 
statementZ 
Statements 
except Exceptionl: 

# Handle exception 1 
except Except!on2: 

# Handle exception 2 

statement4 

Answer the following questions: 

■ Will Statements be executed? 

■ If the exception is not caught, will statement4 be executed? 

■ If the exception is caught in the except block, will statement4 be executed? 

13.19 What is displayed when the following program is run? 

try: 

list = 10 * [0] 
x = list [10] 
printC'Done 
except IndexError: 

printC'Index out of bound") 

13.20 What is displayed when the following program is run? 
def main(): 


try: 

fO 

printC'After the function call") 
except ZeroDivisionError: 

pri ntC'Di vided by zero!") 
except : 

pri ntC'Exception") 


def f(): 

printCl / 0) 

mainO # Call the main function 

I 3.2 I What is displayed when the following program is run? 
def main(): 


try: 

f() 

printC'After the function call") 
except IndexError: 

printC'Index out of bound") 
except : 

pri ntC'Exception in main") 


def f(): 
try: 


s ="abc" 
print(s[3]) 
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except ZeroDivisionError: 

pri ntC'Divided by zero!”) 

mainO # Call the main function 

13.22 Suppose that statementZ causes an exception in the following statement: 

try: 

statementl 
StatementZ 
Statements 
except Exceptionl: 

# Handle exception 
except ExceptionZ: 

# Handle exception 
except Exceptions: 

# Handle exception 
finally: 

statement4 

Statements 

Answer the following questions: 

■ Will Statements he executed if the exception is not caught? 

■ If the exception is of type Exceptions, will statement4 he executed, and will 
Statements be executed? 

13.23 How do you raise an exception in a function? 

13.24 What are the benefits of using exception handling? 

13.25 What is displayed when the following program is run? 

try: 

1st = 10 * [0] 

X = lst[9] 
pri ntC'Done' ) 
except IndexError: 

printC'Index out of bound”) 
el se : 

pri ntC'Nothing is wrong”) 
finally: 

pri ntC'Finally we are here") 
pri ntC'Continue") 

13.26 What is displayed when the following program is run? 

try: 

1st = 10 * [0] 

X = lst[10] 
pri ntC'Done ") 
except IndexError: 

printC'Index out of bound") 
else: 

pri ntC'Nothing is wrong”) 
finally: 

pri ntC'Finally we are here”) 


pri ntC'Continue") 
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13.27 What is wrong in the following code? 

try: 

# Some code here 

except ArithmeticError: 

pri ntC'ArithmeticError") 
except ZeroDivisionError: 

pri ntC'ZeroDivisionError') 

pri ntC'Continue") 

13.28 How do you define a custom exception class? 


13.10 Binary 10 Using Pickling 

To perform binary 10 using pickling, open a file using the mode rb orvibfor reading 
binary or writing binary and invoke the pickle module’s dump and ^oad functions to 
write and read data. 


^/Key 
P? Point 


You can write strings and numbers to a file. Can you write any object such as a list directly to 
a file? Yes. This would require binary 10. There are many ways to perform binary 10 in 
Python. This section introduces binary 10 using the dump and oad functions in the pickl e 
module. 

The Python pi ckl e module implements the powerful and efficient algorithms for serializ- pi ckl e module 
ing and deserializing objects. Serializing is the process of converting an object into a stream serializing 
of bytes that can be saved to a file or transmitted on a network. Deserializing is the opposite deserializing 
process that extracts an object from a stream of bytes. Serializing/deserializing is also known 
as pickling/unpickling or dumping/loading objects in Python. 


13.10.1 Dumping and Loading Objects 

As you know, all data in Python are objects. The pickle module enables you to write and 
read any data using the dump and 1 oad functions. Listing 13.17 demonstrates these functions. 


Listing 13.17 Bi narylODemo. py 

1 import pickle 

2 

3 def mat n O : 

4 # Open file for writing binary 

5 outfile = openCpickle.dat" , "wb") 

6 pickle. dump(45 , outfile) 

7 pickle. dump(56. 6, outfile) 

8 pickle. dumpC'Programming is fun", outfile) 

9 pickle.dumpC [1 , 2, 3, 4], outfile) 

10 outfile.closeO # Close the output file 

11 

12 # Open file for reading binary 

13 infile = openCpickle.dat", "rb") 

14 print(pickle.load(infile)) 

15 print(pickle.load(infile)) 

16 print(pickle.load(infile)) 

17 print(pickle.load(infile)) 

18 infi1e.close() # Close the input file 

19 

20 mainO # Call the main function 


open for binary write 
dump an int 
dump a float 
dump a string 
dump a list 
close file 


open for binary read 
load an object 


close file 
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Programming is fun 
[1, 2, 3, 4] 


To use pickle, you need to import the pickle module (line 1). To write objects to a file, 
open the file using the mode wb for writing binary (line 5) and use the dump (object) 
method to write the object into the file (lines 6-9). This method serializes the object into a 
stream of bytes and stores them in the file. 

The program closes the file (line 10) and opens it for reading binary (line 13). The load 
method is used to read the objects (lines 14-17). This method reads a stream of bytes and 
deserializes them into an object. 


13.10.2 Detecting the End of File 

If you don’t know how many objects are in the file, how do you read all the objects? You can 
repeatedly read an object using the load function until it throws an EOFError (end of file) 
exception. When this exception is raised, catch it and process it to end the file-reading process. 

The program in Listing 13.18 stores an unspecified number of integers in a file by using 
object lO, and then it reads all the numbers back from the file. 


Listing 13.18 DetectEndOfFile.py 



1 

import pickle 


£. 

3 

def mainO : 


4 

# Open file for writing binary 

open for binary write 

5 

outfile = open ("numbers.dat" , "wb' ) 


\J 

7 

data = eval(i nputC'Enter an integer (the input exits " + 


8 

'if the input is 0): ' )) 


9 

while data != 0: 

dump an int 

10 

pickle.dump(data, outfile) 


11 

data = eval(i nputC'Enter an integer (the input exits " + 


12 

"if the input is 0): ")) 


13 


close file 

14 

outfile.closeO # Close the output file 


15 



16 

# Open file for reading binary 

open for binary read 

17 

infile = open("numbers.dat" , "rb' ) 


18 



19 

end_of_file = False 


20 

while not end_of_file: 


21 

try: 

load an object 

22 

print(pickle.load(infile), end = " ) 

handle exception 

23 

except EOFError: 

set end_of_fi ^ e 

24 

end_of_file = True 


25 



26 

infile.closeO # Close the input file 


27 



28 

printC'XnAll objects are read") 


29 



30 

mainO # Call the main function 
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Enter an integer (the input exits if the input is 0) 

4 1-' Enter | 

Enter an integer (the input exits if the input is 0) 

5 |-j Enter | 

Enter an integer (the input exits if the input is 0) 

7 [l^^nte^ 

Enter an integer (the input exits if the input is 0) 

9 1^— 1 Enter | 

Enter an integer (the input exits if the input is 0) 

Q 1 -I Enter | 

4 5 7 9 


All objects are read 




The program opens the file for writing binary (line 5) and repeatedly prompts the 
user to enter an integer and saves it to the file using the dump function (line 10) until the 
integer is 0 . 

The program closes the file (line 14) and reopens it for reading binary (line 17). It repeat¬ 
edly reads an object using the load function (line 22) in a while loop until an EOFError 
exception occurs. When an EOFError exception occurs, end_of_file is to set to True, 
which terminates the while loop (line 20). 

As shown in the sample output, the user entered four integers and they are saved and then 
read back and displayed on the console. 

13.29 How do you open a file for writing objects and reading objects? 

13.30 How do you invoke the function to write an object and to read an object? 

I 3.3 I What is wrong if the code in lines 20-24 in Listing 13.18 is replaced by the fol- MyProgrammingLab" 

lowing code? 

while not end_of_file: 
try: 

print(pickle.load(infile), end = ) 

except EOFError: 

end_of_file = True 
finally: 

infi1e.close() # Close the input file 
13.32 Can you replace the code in lines 20-24 in Listing 13.18 with the following code? 

try: 

while not end_of_file: 

print(pickle.load(infile), end = ) 

except EOFError: 

print("\nAll objects are read") 
finally: 

infile.closeO # Close the input file 



13.11 Case Study: Address Book 

The problem in this case study is to create an address book using binary 10. 

Now we will use object lO to create a useful project for storing and viewing an address book. 
The user interface of the program is shown in Figure 13.11. The Add button stores a new 


tr/Key 
It ? Point 


7^ AddressBook 


74 Address saved 

Name John Smith 

A nnw Mldrr« 1% viwd 

1 Street 100 Main Street 


1 City Savannah State GA ZIP 31409 

1 Add I First [ Next | Previous | Last | 


j 

1* ?!= Jlj 


Figure 13.11 AddressBook stores and retrieves addresses from a file. 
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Address class 


entry variables 


create UI 


address at the end of the file. The First, Next, Previous, and Last buttons retrieve the first, 
next, previous, and last addresses from the file, respectively. 

We will define a class named Address to represent an address and use a list to store all the 
addresses. When the Add button is clicked, the program creates an Address object with 
the name, street, city, state, and ZIP code collected from the user input, appends the object to 
the list, and stores the list to a file using binary lO. Assume that the file is named address.dat. 

When the program is launched, it first reads the list from the file and displays the first 
address from the list in the user interface. If the file is empty, it displays empty entries. The 
program is given in Listing 13.19. 


Listing 13.19 AddressBook.py 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 


import pickle 
import os.path 

from tkinter import * # Import all definitions from tkinter 
import tkinter.messagebox 

class Address: 

def _ _init_(self, name, street, city, state, zip): 

self.name = name 
self.street = street 
self.city = city 
self.state = state 
self.zip = zip 

class AddressBook: 

def _i ni t_(sel f) : 

window = Tk() # Create a window 
window. title(’'AddressBook") # Set title 

self.nameVar = StringVarf) 
self.streetVar = StringVarf) 
self.cityVar = StringVarO 
self.stateVar = StringVarO 
self.zipVar = StringVarO 

framel = Frame(window) 
f ramel. packO 

Label(framel, text = "Name") .grid(row = 1, 
column = 1, sticky = W) 

Entry(framel, textvariable = self.nameVar, 
width = 40).grid(row = 1, column = 2) 

frame2 = Frame(window) 
frame2.pack() 

Label(frame2, text = "Street") .grid(row = 1, 
column = 1, sticky = W) 

Entry(frame2, textvariable = self.streetVar, 
width = 40).grid(row = 1, column = 2) 

frames = Frame(window) 
frames.pack() 

Label(frames, text = "City", width = 5).grid(row = 1, 
column = 1, sticky = W) 

Entry(frameS, 

textvariable = self.cityVar).grid(row = 1, column = 2) 
Label(frames, text = "State") .grid(row = 1, 
column = 3, sticky = W) 

Entry(frameS, textvariable = self.stateVar, 


48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 

60 

61 

62 

63 

64 

65 

66 

67 

68 

69 

70 

71 

72 

73 

74 

75 

76 

77 

78 

79 

80 

81 

82 

83 

84 

85 

86 

87 

88 

89 

90 

91 

92 

93 

94 

95 

96 

97 

98 

99 

100 

101 

102 

103 

104 

105 

106 

107 
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width = 5). grid(row = 1, column = 4) 

Label(frames, text = "ZIP") .grid(row = 1, 
column = 5, sticky = W) 

Entry(frame3, textvariable = self.zipVar, 
width = 5).grid(row = 1, column = 6) 

frame4 = Frame(window) 
frame4.pack() 

Button(frame4, text = 'Add", 

command = self.processAdd).grid(row = 1, column = 1) 
btFirst = Button(frame4, text = "First", 

command = self.processFirst).grid(row = 1, column = 2) 
btNext = Button(frame4, text = "Next", 

command = self.processNext).grid(row = 1, column = 3) 
btPrevious = Button(frame4, text = ‘Previous", command = 
self.processPrevious).grid(row = 1, column = 4) 
btLast = Button(frame4, text = "Last", 

command = self.processLast).grid(row = 1, column = 5) 

self.addressList = self.loadAddressO 
self.current = 0 

if len(self.addressList) > 0: 
self. setAddressO 

window.mainloopO # Create an event loop 

def saveAddress(self): 

outfile = open ("address.dat" , "wb") 
pickle.dump(self.addressList, outfi1e) 
tkinter.messagebox.showinfo( 

"Address saved", "A new address is saved") 
outfile.closeO 

def loadAddress(self): 

if not os.path.isfi1 eC'address.dat") : 
return [] # Return an empty list 


try: 

infile = open ("address.dat" , "rb") 
addressList = pickle.load(infile) 
except EOFError: 

addressList = [] 

infi1e.close() 
return addressList 

def processAdd(self): 

address = Address(self.nameVar.getO, 

self .streetVar.getO , self .cityVar.getO , 
self.stateVar.get(), self.zipVar.get()) 
self.addressList.append(address) 
sel f. saveAddressO 

def processFirst(self): 
self.current = 0 
self.setAddress() 


create buttons 


load addresses 
initialize current 

setAddress 

saveAddress 
store list 

loadAddress 
return empty list 

read list 

return list 

processAdd 
create address 

append address 
store address list 

processFirst 
initialize current 
set address 


def processNext(self): 

if self.current < len(self.addressList) - 1: 


processNext 
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108 

self.current += 1 



109 

sel f. setAddressO 



110 



processPrevious 

111 

def processPrevious(self): 



112 

printC'Left as exercise") 



113 



processLast 

114 

def processLast(self): 



115 

printC'Left as exercise') 



116 



setAddress 

117 

def setAddress(self): 



118 

self.nameVar.set(self.addressList[self.current]. 

name) 


119 

self.streetVar.set(self.address List[self.current].street) 


120 

self.cityVar.set(self.addressList[self.current]. 

city) 


121 

self.stateVar.set(self.addressList[self.current] 

.state) 


122 

self.zipVar.set(self.addressList[self.current].zip) 


123 



create GUI 

124 

AddressBookO # Create GUI 



The Address class is defined with the _i ni t_ method that creates an Address object 
with a name, street, city, state, and ZIP code (lines 6-12). 

The _init_ method in AddressBook creates the user interface for displaying and 
processing addresses (lines 25-65). It reads the address list from the file (line 67) and sets the 
current index for the address in the list to 0 (line 68). If the address list is not empty, the pro¬ 
gram displays the first address (lines 70-71). 

The saveAddress method writes the address list to the file (line 77) and displays a mes¬ 
sage dialog to alert the user that a new address has been added (lines 78-79). 

The loadAddress method reads the address list to the file (line 88). If the file does not 
exist, the program returns an empty list (lines 83-84). 

The processAdd method creates an Address object using the values from the entries. It 
appends the object to the list (line 99) and invokes the saveAddress method to store the 
newly updated list to the file (line 100). 

The processFi rst method resets current to 0, which points to the first address in the 
address list (line 103). It then sets the address in the entries by invoking the setAddress 
method (line 104). 

The processNext method moves current to point to the next address in the list (line 
108) if current is not pointing to the last address in the list (line 107) and resets the address 
in the entries (line 109). 

The setAddress method sets the address fields for the entries (lines 117-122). The meth¬ 
ods processPrevious and process Last are left as an exercise. 
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Chapter Summary 


1. You can use file objects to read/write data from/to files. You can open a file to create 
a file object with mode r for reading, w for writing, and a for appending. 

2. You can use the os. path. isfile(f) function to check if a file exists. 
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3. Python has a file class that contains the methods for reading and writing data, and for 
closing a file. 

4 . You can use the readC), readlineC), and readlinesC) methods to read data 
from a file. 

5 . You can use the wri te(s) method to write a string to a file. 

6 . You should close the file after the file is processed to ensure that the data is saved properly. 

7. You can read a Web resource just like reading data from a file. 

8 . You can use exception handling to catch and handle runtime errors. You place the 
code that may raise an exception in the try clause, list the exceptions in the except 
clauses, and process the exception in the except clause. 

9. Python provides built-in exception classes such as ZeroDivisionError, 

SyntaxError, and RuntimeError. All Python exception classes inherit directly or 
indirectly from BaseException. You can also define your own exception class 
derived from BaseException or from a subclass of BaseException, such as 
RuntimeError. 

10. You can use the Python pickl e module to store objects in a file. The dump function 
writes an object to the file and the '' oad function reads an object from the file. 

Test Questions 

Do test questions for this chapter online at www.cs.ami.strong.edu/liang/py/test.html. 

Programming Exercises MyProgrammingLab" 


Sections 13.2-13.5 

**I3.I {Remove text) Write a program that removes all the occurrences of a specified 
string from a text file. Your program should prompt the user to enter a filename 
and a string to be removed. Here is a sample run: 


Enter a filename: test.txt Enter| 

Enter the string to be removed: morning 
Done 


* I 3.2 (Count characters, words, and lines in a file) Write a program that will count the 
number of characters, words, and lines in a file. Words are separated by a white- 
space character. Your program should prompt the user to enter a filename. Here is 
a sample run: 


Enter a filename: test.txt h 
1777 characters 
210 words 
71 lines 
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*13.3 (Process scores in a text file) Suppose that a text file contains an unspecified num¬ 
ber of scores. Write a program that reads the scores from the file and displays their 
total and average. Scores are separated by blanks. Your program should prompt 
the user to enter a filename. Here is a sample run; 



Enter a filename: scores.txt 
There are 70 scores 
The total is 800 
The average is 33.33 


* I 3.4 (Write/read data) Write a program that writes 100 integers created randomly into 
a file. Integers are separated by a space in the file. Read the data back from the file 
and display the sorted data. Your program should prompt the user to enter a file¬ 
name. If the file already exists, do not override it. Here is a sample run: 





** 13.5 (Replace text) Write a program that replaces text in a file. Your program should 
prompt the user to enter a filename, an old string, and a new string. Here is a 
sample run: 



Enter a filename: test.txt [center| 

Enter the old string to be replaced: morning enter| 

Enter the new string to replace the old string: afternoon Center 
Done 


*13.6 (Count words) Write a program that counts the number of words in President 
Abraham Lincoln’s Gettysburg Address from http://cs.armstrong.edu/liang/data/ 
Lincoln.txt. 

** I 3.7 (Game: hangman) Rewrite Exercise 10.29. The program reads the words stored 
in a text file named hangman.txt. Words are delimited by spaces. 

I 3.8 (Encryptfides) Encode the file by adding 5 to every byte in the file. Write a pro¬ 
gram that prompts the user to enter an input filename and an output filename and 
saves the encrypted version of the input file to the output file. 

13.9 (Decrypt files) Suppose a file is encrypted using the scheme in Exercise 13.8. 
Write a program to decode an encrypted file. Your program should prompt the 
user to enter an input filename and an output filename and should save the unen¬ 
crypted version of the input file to the output file. 
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Sections 13.6-13.9 

13.10 (The Rational class) Modify the Rational class in Listing 8.4, Rational.py, to 
throw a RuntimeError exception if the denominator is 0. 

13.1 I (The Triangle class) Modify the Triangle class in Programming Exercise 12.1 
to throw a RuntimeError exception if the three given sides cannot form a 
triangle. 

13.12 (The TriangleError class) Define an exception class named TriangleError 
that extends RuntimeError. The TriangleError class contains the private 
data fields sidel, side2, and sideB with accessor methods for the three 
sides of a triangle. Modify the Triangle class in Exercise 12.1 to throw a 
TriangleError exception if the three given sides cannot form a triangle. 

Sections 13.10-13.11 

** I 3.1 3 (Tkinter: display a graph) A graph consists of vertices and edges that connect 
vertices. Write a program that reads a graph from a file and displays it on a 
panel. The first line in the file contains a number that indicates the number of 
vertices (n). The vertices are labeled as 0, 1, ..., n-1. Each subsequent line, with 
the format u x y vl, v2, . . . , describes that the vertex u is located at position 
(x, y) with the edges (u, vl), (u, v2), and so on. Figure 13.12a gives an example 
of the file for a graph. Your program prompts the user to enter the name of the 
file, reads data from the file, and displays the graph on a panel, as shown in 
Figure 13.12b. 


Fi 1 e 
6 

0 30 30 1 2 

1 90 30 0 3 

2 30 90 0 3 4 

3 90 90 1 2 4 5 

4 30 150 2 3 5 

5 90 150 3 4 

(a) 

Figure 13.12 The program reads the information about the graph and displays it visually. 




(b) 


** I 3.14 {Tkinter: display a graph) Rewrite Exercise 13.13 to read data from a Web URL 
such as http://cs.armstrong.edu/liang/data/graph.txt. The program should prompt the 
user to enter the URL for the file. 

**13.15 {Tkinter: address book) Rewrite the address book case study in Section 13.11 with 
the following improvements, as shown in Figure 13.13: 

(a) Add a new button named Update. Clicking it enables the user to update the 
address that is currently displayed. 

(b) Add a label below the buttons to display the current address location and the 
total number of addresses in the list. 

(c) Implement the unfinished processPrevious and processLast methods in 
Listing 13.19. 
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AddressBook 

1 ^. _ 




Name Mark Twain 



Name John King 



Street 5 West Lake Street 



Street tl23 Main Street 


1 

City [Orlando State [fL ZIP 4065t| 



City Savannah State |gA aP 31409| 



Add 1 First | Next | Previous | Last | Update | 

1 


1 Add 1 First | Next | Previous | Last | Update j 



current address index: 0 number of addresses: 4 



1 current address index: 3 / number of addresses: 4 

1 


Figure 13.13 The new Update button and status label are added in the AddressBook UI. 


**13.16 {Create large dataset) Create a data file with 1000 lines. Each line in the file con¬ 
sists of a faculty first name, last name, rank, and salary. Faculty’s first name and 
last name for the ith line are FirstNamei and LastNamei. The rank is randomly 
generated as assistant, associate, and full. The salary is randomly generated as a 
number with two digits after the decimal point. The salary for assistant professor 
should be in the range from 50,000 to 80,000, for associate professor from 60,000 
to 110,000, and for full professor from 75,000 to 130,000. Save the file in 
Salary.txt. Here are some sample data:. 

FirstNamei LastNamei assistant 60055.95 
FirstName2 LastName2 associate 81112.45 

FirstNamelOOO LastNamelOOO full 92255.21 

*13.17 {Process large dataset) A university posts its employee salary at http://cs 
.armstrong.edu/liang/data/Salary.txt. Each line in the file consists of faculty first 
name, last name, rank, and salary (see Exercise 13.16). Write a program to display 
the total salary for assistant professors, associate professors, full professors, and 
all faculty, respectively, and display the average salary for assistant professors, 
associate professors, full professors, and all faculty, respectively. 



















CHAPTER 


14 

Tuples, Sets, and 
Dictionaries 

objectives 

■ To create tuples (§14.2). 

■ To use tuples as fixed lists to prevent elements from being added, deleted, or 
replaced (§14.2). 

■ To apply common sequence operations for tuples (§ 14.2). 

■ To create sets (§14.3.1). 

■ To add and remove elements in a set using the add and remove methods 
(§14.3.2). 

■ To use the 1 en, min, max, and sum functions for a set of elements (§ 14.3.2). 

■ To use the i n and not i n operators to determine whether an element is in a 
set (§14.3.2). 

■ To traverse the elements in a set using a for loop (§14.3.2). 

■ To test whether a set is a subset or a superset of another set using the 
issubset or issuperset method (§14.3.3). 

■ To test whether two sets have the same contents using the == operator (§14.3.4). 

■ To perform set union, intersection, difference, and symmetric difference 
using the operators , &, , and A (§14.3.5). 

■ To compare the performance differences between sets and lists (§14.4). 

■ To use sets to develop a program that counts the keywords in a Python source 
file (§14.5). 

■ To create dictionaries (§14.6.1). 

■ To add, modify, and retrieve elements in a dictionary using the syntax 
dictionaryName[key] (§14.6.2). 

■ To delete items in a dictionary using the del keyword (§14.6.3). 

■ To traverse keys in a dictionary using a for loop (§ 14.6.4). 

■ To obtain the size of a dictionary using the len function (§14.6.5). 

■ To test whether a key is in a dictionary using the i n or not i n operator 
(§14.6.6). 

■ To test whether two dictionaries have the same content using 
the operator (§14.6.7). 

■ To use the keys, val ues, i terns, cl ean, get, pop, and popi tern 

methods on a dictionary (§14.6.8). 

■ To use dictionaries to develop applications (§14.7). 
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problem 
data structure 


tuple 

creating tuples 


tuple operations 


create a tuple 


c/Key 
Ip / Point 


14-1 Introduction 

You can use a tuple for storing a fixed list of elements, a set for storing and quickly 


Point accessing nonduplicate elements, and a dictionary for storing key/value pairs and for 
accessing elements quickly using the keys. 

The “No-Fly” list is a list, created and maintained by the U.S. government’s Terrorist Screening 
Center, of people who are not permitted to board a commercial aircraft for travel in or out of 
the United States. Suppose we need to write a program that checks whether a person is on 
the No-Fly list. You can use a Python list to store names in the No-Fly list. However, a more 
efficient data structure for this application is a set. In computer science, a data structure is a 
particular way of storing and organizing data in a computer so that it can be used efficiently for 
certain applications. 

This chapter introduces sets along with two additional useful data structures—tuples and 
dictionaries. 


14-2 Tuples 


r/Key 
IT' / Point 


Tuples are like lists, but their elements are fixed; that is, once a tuple is created, you 
cannot add new elements, delete elements, replace elements, or reorder the elements in 
the tuple. 

If the contents of a list in your application shouldn’t change, you can use a tuple to prevent 
elements from being added, deleted, or replaced accidentally. A tuple is very much like a list, 
except that its elements are fixed. Furthermore, tuples are more efficient than lists due to 
Python’s implementations. 

You create a tuple by enclosing its elements inside a pair of parentheses. The elements are 
separated by commas. You can create an empty tuple and create a tuple from a list, as shown 
in the following example: 

tl = () # Create an empty tuple 

t2 = (1, 3, 5) # Create a tuple with three elements 

# Create a tuple from a list 

t3 = tuple([2 * X for x in rangefl, 5)]) 

You can also create a tuple from a string. Each character in the string becomes an element 
in the tuple. For example: 


# Create a tuple from a string 

t4 = tuple(’'abac") # t4 is ['a', 'b', 'a' 


■C] 


Tuples are sequences. The common operations for sequences in Table 10.1 can be used for 
tuples. You can use the functions 1 en, min, max, and sum on a tuple. You can use a for loop 
to traverse all elements in a tuple, and can access the elements or slices of the elements using 
an index operator. You can use the i n and not i n operators to determine whether an element 
is in a tuple, and can also compare the elements in tuples using the comparison operators. 
Listing 14.1 gives an example of using tuples. 

Listing I4.I TupleDemo.py 

1 tuplel = ("green", "red", "blue") # Create a tuple 

2 printftuplel) 

3 

4 tuple2 = tuple([7, 1, 2, 23, 4, 5]) # Create a tuple from a list 

5 print(tuple2) 

6 
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7 pri ntC'length is", len(tuple2)) # Use function Ten usefunctions 


8 

printC'max is", max(tuple2)) # Use max 


9 

printC'min is", min(tuple2)) # Use min 


10 

printC'sum is", sum(tuple2)) # Use sum 


11 



12 

printC'The first element is", tuple2[0]) # Use index operator 

index operator 

13 



14 

tuple3 = tuplel + tuple2 # Combine two tuples 

+ 

15 

print(tuple3) 


16 



17 

tuple3 = 2 * tuplel # Duplicate a tuple 

* 

18 

print(tuple3) 


19 



20 

print(tuple2 [2 : 4]) # Slicing operator 

slicing 

21 

print(tuplel[-l]) 


22 



23 

print(2 in tuple2) # in operator 

i n operator 

24 



25 

for V in tuplel: 

for loop 

26 

print(v, end = ' ') 


27 

pri nt() 


28 



29 

listl = list(tuple2) # Obtain a list from a tuple 

create a list from tuple 

30 

listl.sortO 


31 

tuple4 = tuple(listl) 


32 

tuple5 = tuple(listl) 


33 

print(tuple4) 


34 

print(tuple4 == tuple5) # Compare two tuples 

compare 


('green', 

'red', 

'blue') 




(7, 1, 2, 

23, 4, 

5) 




length is 
max is 23 
min is 1 
sum is 42 

6 





The fi rst 

element is 7 




('green', 

'red', 

'blue', 

7, 1, 2, 

23, 4, 

5) 

('green', 
(2, 23) 
bl ue 

'red', 

'blue', 

'green' , 

'red', 

'blue') 

T rue 

green red 

bl ue 





(1, 2, 4, 
T rue 

Fal se 

5, 7, 

23) 






The program creates tuple tupl el with some strings (line 1) and tuple tupl e2 from a list 
(line 4). It applies the len, max, min, and sum functions on tup1e2 (lines 7-10). You can use 
the index operator to access elements in a tuple (line 12), the + operator to combine two tuples 
(line 14), the * operator to duplicate a tuple (line 17), and the slicing operator to get a portion 
of the tuple (lines 20-21). You can use the i n operator to determine whether a specific element 
is in a tuple (line 23). The elements in a tuple can be traversed using a for loop (lines 25-26). 

The program creates a list (line 29), sorts the list (line 30), and then creates two tuples from 
this list (lines 31-32). The comparison operator == is used to compare tuples (line 34). 

Tuples have fixed elements. So wouldn’t the statement in line 17 throw an error since 
tupl e3 has already been defined in line 14? Line 17 is fine, though, because it assigns a new 
tuple to variable tupl e3. Now tupl e3 points to the new tuple. “Tuples have fixed elements” 
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immutable tuple 

^heck 
W Point 

MyProgrammingLab" 


means that you cannot add new elements, delete elements, replace the elements, or shuffle the 
elements in a tuple. 

Note 

A tuple contains a fixed list of elements. An individual element in a tuple may be muta¬ 
ble. For example, the following code creates a tuple of circles (line 2), and changes the 
first circle’s radius to 30 (line 3). 



1 »> from Ci rcl eFrotrCeometri cObject import Circle 

2 »> circles = (Circle(2), Circle(4), Circle(7)) 

3 »> ci rcl es [0] . setRadi us(30) 

4 »> ci rcl es [0] .getRadi us() 

5 »> 30 

6 »> 


In this example, each element in the tuple is a circle object. Even though you cannot 
add, delete, or replace circle objects in the tuple, you can change a circle's radius, since 
a circle object is mutable. If a tuple contains immutable objects, the tuple is said to be 
immutable. For example, a tuple of numbers or a tuple of strings is immutable. 

14.1 What are the differences between a list and a tuple? How do you create a tuple from a 
list? How do you create a list from a tuple? 

14.2 What is wrong in the following code? 

t = (1, 2, 3) 
t. append (4) 
t. remove (0) 
t[0] = 1 

14.3 Is the following code correct? 

tl = (1, 2, 3, 7, 9, 0, 5) 
t2 = (1, 2, 5) 
tl = t2 

14.4 Show the printout of the following code: 

t = (1, 2, 3, 7, 9, 0, 5) 

print(t) 

print(t[0]) 

print(t[l: 3]) 

print(t[-l]) 

print(t[ : -1]) 

print(t[l : -1]) 

14.5 Show the printout of the following code: 

t = (1, 2, 3, 7, 9, 0, 5) 
print(max(t)) 
print(min(t)) 
print(sum(t)) 
print(len(t)) 

14.6 Show the printout of the following code: 

tl = (1, 2, 3, 7, 9, 0, 5) 
t2 = (1, 3, 22, 7, 9, 0, 5) 
printCtl == t2) 
printCtl != t2) 
print(tl > t2) 
printftl < t2) 
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14-3 Sets 

Sets are like lists in that you use them for storing a collection of elements. Unlike lists, 
however, the elements in a set are nonduplicates and are not placed in any particular 
order. 


P ^Poi 


Key 

Point 


If your application does not care about the order of the elements, using a set to store elements 
is more efficient than using lists due to Python’s implementations. This section introduces ^et 
how to use sets. 


14-3.1 Creating Sets 

You can create a set of elements by enclosing the elements inside a pair of curly braces ({}). videoNote 

The elements are separated by commas. You can create an empty set, or you can create a set Use sets 
from a list or a tuple, as shown in the following examples: 

si = set() # Create an empty set 

s2 = {1, 3, 5} # Create a set with three elements 

s3 = set([l, 3, 5]) # Create a set from a tuple 

# Create a set from a list 

s4 = set([x * 2 for x in rangefl, 10)]) 

Likewise, you can create a list or a tuple from a set by using the syntax 1 istCset) or 
tuple(set). 

You can also create a set from a string. Each character in the string becomes an element in 
the set. For example: 

# Create a set from a string 

s5 = setC'abac") # s5 is {'a', 'b', 'c'} 

Note that although the character a appears twice in the string, it appears only once in the 
set because a set does not store duplicate elements. 

A set can contain the elements of the same type or mixed types. For example, s = { 1, 2, 3, 

"one", "two", "three"} is a set that contains numbers and strings. Each element in a set 
must be hashable. Each object in Python has a hash value and an object is hashable if its hash hashable 
value never changes during its lifetime. All types of objects introduced so far except lists are 
hashable. Why set elements must be hashable is explained in bonus Web Chapter 21, Hashing: 
Implementing Sets and Dictionaries. 

14-3.2 Manipulating and Accessing Sets 

You can add an element to a set or remove an element by using the add(e) or remove Ce) 
method. You can use the Ten, min, max, and sum functions on a set, and a for loop to tra¬ 
verse all elements in a set. 

You can use the i n or not i n operator to determine whether an element is in the set. For 
example: 


»> si = {1, 2, 4} 
»> si.add(6) 

»> si 
{1, 2, 4, 6} 

»> len(sl) 

4 

»> max(sl) 

6 
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»> min (si) 

1 

»> sum(sl) 

13 

»> 3 in si 
Fal se 

»> si. remove(4) 
»> si 
{ 1 , 2 , 6 } 

»> 



Note 

The remove(e) method will throw a KeyError exception if the element to be 
removed is not in the set. 


14-3.3 Subset and Superset 

A set si is a subset of s2 if every element in si is also in s2. You can use the 
issubset sl. 1 ssubsetCs2) method to determine whether si is a subset of s2, as shown in the 

following code: 


»> sl = {1, 2, 

4} 


»> s2 = {1, 4, 

5, 2, 

6} 

»> sl.issubset(s2) # 

sl is a subset of s2 

T rue 



»> 





issuperrset 


A set sl is a superset of set s2 if every element in s2 is also in sl. You can use the 
sl. issuperset(s2) method to determine whether sl is a superset of s2, as shown in the 
following code: 



»> sl = {1, 2, 4} 

»> s2 = {1, 4, 5, 2, 6} 

»> s2.issuperset(sl) # s2 is a superset of sl 
T rue 
»> 


14-3.4 Equality Test 

You can use the == and ! = operators to test if two sets contain the same elements. For 
example: 



»> sl 

= {1, 

2, 

4} 

»> s2 

= {1, 

4, 

2} 

»> sl 

== s2 



T rue 




»> sl 

!= s2 



Fal se 




»> 













14.3 Sets 481 


In this example, si and s2 contain the same elements regardless of the order of the ele¬ 
ments in the sets. 

Note that it makes no sense to compare the sets using the conventional comparison opera¬ 
tors (>, >=, <=, and <), because the elements in a set are not ordered. However, these operators 
have special meanings when used for sets: 

■ si < s2 returns True if si is a proper subset of s2. 

■ si <= s2 returns True if si is a subset of s2. 

■ si > s2 returns True if si is a proper superset of s2. 

■ si >= s2 returns True if si is a superset of s2. 

Note 

If si is a proper subset of s2, every element in si is also in s2, and at least one element 
in s2 is not in si. If si is a proper subset of s2, s2 is a proper superset of si. 



14-3.5 Set Operations 

Python provides the methods for performing set union, intersection, difference, and symmet¬ 
ric difference operations. 

The union of two sets is a set that contains all the elements from both sets. You can use the set union 
union method or the operator to perform this operation. For example: uni on | 




The intersection of two sets is a set that contains the elements that appear in both sets. You can set intersection 

use the intersection method or the & operator to perform this operation. For example: intersection & 




The difference between setl and set2 is a set that contains the elements in setl but not set difference 
in set2. You can use the difference method or the operator to perform this operation, difference - 
For example: 


»> si = {1, 2, 4} 

»> s2 = {1, 3, 5} 

»> sl.difference(s2) 
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set symmetric_difference 
symmetric_difference a 




create a set 

create a set from list 

is in set? 


union | 

difference - 

intersection & 

exclusive or A 

create a list from set 
compare 


{2, 4} 

»> 

»> si - s2 
{2, 4} 

»> 


The symmetric difference (or exclusive or) of two sets is a set that contains the elements in 
either set, but not in both sets. You can use the symmetric_di fference method or the A 
operator to perform this operation. For example: 


»> si = {1, 2, 4} 

»> s2 = {1, 3, 5} 

»> sl.symmetric_difference(s2) 
{2, 3, 4, 5} 

»> 

»> si A S2 
{2, 3, 4, 5} 

»> 


Note that these set methods return a resulting set, but they do not change the elements in 
the sets. 

Listing 14.2 illustrates a program that uses sets. 


Listing 14*2 SetDemo.py 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 
29 


setl = {"green", "red", "blue", "red"} # Create a set 
print(setl) 

set2 = set([7, 1, 2, 23, 2, 4, 5]) # Create a set from a list 
print(set2) 

printC'Is red in setl?", "red" in setl) 


pri ntC'length is", len(set2)) # Use function len 
printC'max is", max(set2)) # Use max 
printC'min is", min(set2)) # Use min 
printC'sum is", sum(set2)) # Use sum 


set3 = setl | {"green" _ "yellow"} # Set union 
print(set3) 

set3 = setl - {"green"^ "yellow"} # Set difference 
print(set3) 


set3 = setl & {"green"^ "yellow"} # Set intersection 
print(set3) 

set3 = setl a {"green"^ "yellow"} # Set exclusive or 
print(set3) 


listl = list(set2) # Obtain a list from a set 
print(setl == {"green", "red", "blue"}) # Compare two sets 

setl.add ("yellow") 
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30 print(setl) 

31 

32 setl. removeC'yel low' ) 

33 print(setl) 


{'blue', 

'green 

, 'red'} 


{1, 2, 4, 5, 7, 

23} 


Is red in setl? 
length is 6 
max is 23 
min is 1 
sum is 42 

T rue 


{'blue', 'green 
{'blue', 'red'} 
{'green'} 

, 'yellow'. 

'red'} 

{'blue', 'red', 
T rue 

'yellow'} 


{'blue' 

'green 

, 'yellow'. 

'red'} 

{'blue' 

'green 

, 'red'} 



The program creates setl as {"green" , "red" , "bl ue" , "red"} (line 1). Because 
a set does not contain any duplicates, only one element red is stored in setl. The program 
creates set2 from a list using the set function (line 4). 

The program applies the len, max, min, and sum functions on the sets (lines 9-12). Note 
that you cannot use the index operator to access elements in a set, because the elements are 
not in any particular order. 

The program performs the set union, difference, intersection, and symmetric difference 
operations in lines 14-24. 

Set union: {"green", "red", "blue"} | {"green", "yellow"}) 

=> {"green", "red", "blue", "yellow"} (line 14) 

Set difference: {"green", "red", "blue"} - {"green", "yellow"}) 

=> {"red", "blue"} (line 17) 

Set intersection: {"green", "red", "blue"} & {"green", "yellow"}) 

=> {"green"} (line 20) 

Set symmetric_difference: {"green", "red", "blue"} a {"green", "yellow"}) 

=> {"red", "blue", "yellow"} (line 23) 

The program uses == to determine whether the two sets have the same elements (line 27). 

The program uses the add and remove methods to add and remove an element in the set 
(lines 29 and 32). 

14.7 How do you create an empty set? 

14.8 Can a list, set, or tuple have elements of different types? 

14.9 Which of the following sets are created correctly? 

s = {1, 3, 4} 
s = {{1, 2}, {4, 5}} 

s = {[1, 2] , [4, 5]} 

s = {(1, 2), (4, 5)} 

14.10 What are the differences between a list and a set? How do you create a set from a list? 
How do you create a list from a set? How do you create a tuple from a set? 



len, max, min, sum 
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14.11 Show the printout of the following code: 

students = {"peter", "john"} 
print(students) 
students. addC'john") 
print(students) 
students. add("peterson") 
print(students) 
students. remove("peter") 
print(students) 

14.12 Will the following code have a runtime error? 

students = {"peter", "john"} 
students.removef ' Johnson") 
print(students) 

14.13 Show the printout of the following code: 

studentl = {"peter", "john", "tim"} 
student2 = {"peter", "Johnson", "tim"} 
printfstudentl.i ssuperset({"john"})) 
printfstudentl.issubset(student2)) 
print({l, 2, 3} > {1, 2, 4}) 
print({l, 2, 3} < {1, 2, 4}) 
print({l, 2} < {1, 2, 4}) 
print({l, 2} <= {1, 2, 4}) 

14.14 Show the printout of the following code: 

numbers = {1, 4, 5, 6} 
print(}en(numbers)) 
print(max(numbers)) 
print(min(numbers)) 
print(surn(numbers)) 

14.15 Show the printout of the following code: 

si = {1, 4, 5, 6} 

s2 = {1, 3, 6, 7} 

print(sl.union(s2)) 

print(sl I s2) 

print(sl.intersection(s2)) 

print(sl & s2) 

print(sl.difference(s2)) 

print(sl - s2) 

pri nt(sl.symmetric_difference(s2)) 
print(sl A s2) 

14.16 Show the printout of the following code: 

setl = {2, 3, 7, 11} 
print(4 in setl) 
print(3 in setl) 
print(}en(setl)) 
print(max(setl)) 
print(min(setl)) 
print(sum(setl)) 

print(setl.i ssubset({2 , 3, 6, 7, 11})) 
print(setl.i ssuperset({2 , 3 , 7, 11})) 

14.17 Show the output of the following code: 

setl = {1, 2, 3} 
set2 = {3, 4, 5} 


sets = setl I set2 
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print(setl, set2, set3) 

sets = setl - set2 
print(setl, set2, set3) 


sets = setl & set2 
print(setl, set2, set3) 

sets = setl A set2 
print(setl, set2, set3) 


14.4 Comparing the Performance of Sets and Lists 

Sets are more efficient than lists for the i n and not i n operator and for the remove 
method. 


Point 


The elements in a list can be accessed using the index operator. However, sets do not support 
the index operator, because the elements in a set are unordered. To traverse all elements in a 
set, use a for loop. We now conduct an interesting experiment to test the performance of sets 
and lists. The program in Listing 14.3 shows the execution time of (1) testing whether an 
element is in a set and a list, and (2) removing elements from a set and a list. 


Listing 14-3 SetListPerformanceTest.py 

1 import random 

2 import time 

3 

4 NUMBER_OF_ELEMENTS = 10000 

5 

6 # Create a list 

7 1st = list(range(NUMBER_OF_ELEMENTS)) create a list 

8 random.shuffle(lst) 

9 

10 # Create a set from the list 

11 S = set (1st) create a set 

12 

13 # Test if an element is in the set 

14 startTime = time.timeO # Get start time 

15 for i in range(NUMBER_OF_ELEMENTS): 

16 i i n S number in set? 

17 endTime = time.timeO # Get end time 

18 runTime = int( (endTime - startTime) * 1000) # Get test time get run time 

19 print ("To test if", NUMBER_0F_ELEMENTS, 

20 "elements are in the set\n", 

21 "The runtime is", runTime, "milliseconds") 

22 

23 # Test if an element is in the list 

24 StartTime = time.timeO # Get start time 

25 for i in range(NUMBER„OF_ELEMENTS): 

26 iinlst number in list? 

27 endTime = time.timeO # Get end time 

28 runTime = int((endTime - startTime) * 1000) # Get test time 

29 print ("\nTo test if", NUMBER_0F_ELEMENTS, 

30 "elements are in the list\n", 

31 "The runtime is", runTime, "milliseconds") 

32 

33 # Remove elements from a set one at a time 

34 StartTime = time.timeO # Get start time 
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remove from set 


remove from list 


35 for 1 in range(NUMBER_OF_ELEMENTS): 

36 s.remove(i) 

37 endTime = time.timeO # Get end time 

38 runTime = int((endTime - startTime) * 1000) # Get test time 

39 print("\nTo remove", NUMBER_OF_ELEMENTS, 

40 "elements from the set\n", 

41 "The runtime is", runTime, "milliseconds") 

42 

43 # Remove elements from a list one at a time 

44 StartTime = time.timeO # Get start time 

45 for i in range(NUMBER_OF_ELEMENTS): 

46 1st.remove(i) 

47 endTime = time.timeO # Get end time 

48 runTime = int((endTime - startTime) * 1000) # Get test time 

49 print("\nTo remove", NUMBER_0F_ELEMENTS, 

50 "elements from the list\n", 

51 "The runtime is", runTime, "milliseconds") 



To test if 10000 elements are in the set 
The runtime is 5 milliseconds 

To test if 10000 elements are in the list 
The runtime is 4274 milliseconds 

To remove 10000 elements from the set 
The runtime is 7 milliseconds 

To remove 10000 elements from the list 
The runtime is 1853 milliseconds 


In line 7, the range(NUMBER_OF_ELEMENTS) function returns a sequence of numbers from 
0 to NUMBER_OF_ELEMENTS - 1. So 1ist(rangeCNUMBER_OF_ELEMENTS)) returns a list 
of integers from 0 to NUMBER_OF_ELEMENTS - 1 (line 7). The program shuffles the list (line 
8), and creates a set from the list (line 11). Now the set and the list contain the same elements. 

The program obtains the runtime for testing whether the elements 0 to 
NUMBER_OF_ELEMENTS - 1 are in the set (lines 14—21) and in the list (lines 24-31). As you can 
see in the output, it takes 5 milliseconds to test this for the set and 4,274 milliseconds for the list. 

The program obtains the runtime for removing the elements 0 to NUMBER_OF_ELEMENTS 
- 1 from the set (lines 34-41) and in the list (lines 44-51). Again, you can see in the output 
that it takes 7 milliseconds for the set and 1,853 milliseconds for the list. 

As these runtimes illustrate, sets are much more efficient than lists for testing whether an 
sets are better element is in a set or a list. So, the “No-Fly” list mentioned at the beginning of this chapter 

should be implemented using a set instead of a list, because it is much faster to test whether an 
element is in a set than in a list. 

You may wonder why sets are more efficient than lists. To get the answers, read the online 
bonus chapters bonus chapters on developing efficient algorithms, linked lists, and hashing. 




14-5 Case Study: Counting Keywords 

This section presents an application that counts the number of the keywords in a 
Python source file. 


For each word in a Python source file, we need to determine whether the word is a keyword. 
To handle this efficiently, store all the keywords in a set and use the i n operator to test if a 
word is in the keyword set. Listing 14.4 gives this program. 
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Listing 14-4 CountKeywords. py 

1 import os.path 

2 import sys 

3 

4 def mai n () : 

5 keywords 

6 

7 

8 
9 

10 
11 

12 filename = input("Enter a Python source code filename: ").stripO 

13 

14 if not os.path.isfi1e(fi1ename): # Check if file exists 

15 pri ntC'File'" , filename, 'does not exist") 

16 sys.exitO 

17 

18 infile = open(filename, "r") # Open files for input 

19 

20 text = infi1e.readO.split() # Read and split words from the file 

21 

22 count = 0 

23 for word in text: 

24 if word in keywords: 

25 count += 1 

26 

27 printC'The number of keywords in' , filename, "is", count) 

28 

29 mainO 


= {"and", "as", "assert", "break", "class", 

"continue", "def", "del", "elif", "else", 

"except", "False", "finally", "for", "from", 
"global", "if", "import", "in", "is", "lambda", 
"None", "nonlocal", "not", "or", "pass", "raise", 
"return", "True", "try", "while", "with", "yield"} 


Enter a Python source code filename: GuessNumber.py |^Enter 
The number of keywords in GuessNumber.py is 7 


Enter a Python source file: TTT.py |-i Enter"’ 
File TTT.py does not exist 


The program creates a set for keywords (lines 5-10) and prompts the user to enter a 
Python source filename (line 12). It checks if the file exists (line 14). If not, exit the program 
(line 16). 

The program opens the file and splits the words from the text (line 20). For each word, the 
program checks if the word is a keyword (line 24). If so, increase the count by 1 (line 25). 


14-6 Dictionaries 

A dictionary is a container object that stores a collection of key/value pairs. It enables 
fast retrieval, deletion, and updating of the value by using the key. 

Suppose your program needs to store the detailed information on terrorists in the “No-Fly” 
list. A dictionary is an efficient data structure for such a task. A dictionary is a collection that 


keyword set 


enter a filename 
file exists? 

open file 

read and split words 

is a keyword? 
count keyword 

IP 7 Point 

dictionary 

what is a dictionary? 
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key/value pair 
dictionary item 
dictionary entry 
map 



VideoNote 

Use dictionaries 


stores the values along with the keys. The keys are like an index operator. In a list, the indexes 
are integers. In a dictionary, the key must be a hashable object. A dictionary cannot contain 
duplicate keys. Each key maps to one value. A key and its corresponding value form an item 
(or entry) stored in a dictionary, as shown in Figure 14.1a. The data structure is a called a “dic¬ 
tionary” because it resembles a word dictionary, where the words are the keys and the words’ 
definitions are the values. A dictionary is also known as a map, which maps each key to a 
value. 


A dictionary 



(a) 



Figure 14-1 A dictionary’s item is a key/value pair. 


14-6.1 Creating a Dictionary 

You can create a dictionary by enclosing the items inside a pair of curly braces ({}). Each 
item consists of a key, followed by a colon, followed by a value. The items are separated by 
commas. For example, the following statement: 

students = {"111-34-3434" : "John" , "132-56-6290" : "Peter"} 

creates a dictionary with two items, as shown in Figure 14.1b. The item is in the form 
keyrvalue. The key in the first item is 111-34-3434, and its corresponding value is John. 
The key must be of a hashable type such as numbers and strings. The value can be of 
any type. 

You can create an empty dictionary by using the following syntax: 
students = {} # Create an empty dictionary 


Note 

python uses curly braces for sets and dictionaries. The syntax {} denotes an empty dic¬ 
tionary. To create an empty set, use set(). 

14.6.2 Adding, Modifying, and Retrieving Values 

To add an item to a dictionary, use the syntax: 
dictionaryName[key] = value 
For example: 

students ['234-56-9010'] = "Susan" 

If the key is already in the dictionary, the preceding statement replaces the value for the key. 
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To retrieve a value, simply write an expression using dictionaryName[key] . If the key 
is in the dictionary, the value for the key is returned. Otherwise, a KeyError exception is 
raised. 

For example: 


1 

»> students = {"111-34-3434 

":"John", "132-56-6290":"Peter"} 

2 

»> students["234-56-9010"] 

= "Susan" # Add a new item 

3 

»> students["234-56-9010"] 


4 

"Susan" 


5 

»> students["111-34-3434"] 

= "John Smith" 

6 

»> students["111-34-3434"] 


7 

"John Smith" 


8 

»> student["343-45-5455"] 


9 

Traceback (most recent call 

1ast): 

10 

File "<stdin>", line 1, in 

<module> 

11 

KeyError: '343-45-5455' 


12 

»> 




Line 1 creates a dictionary with two items. Line 2 adds a new item with the key 234-56- 
9010 and the value Susan. The value associated with the key 234-56-9010 is returned in 
line 3. Line 5 modifies the item for the key 111-34-3434 with the new value John Smith, 
and line 8 retrieves the value for a nonexistent key 343-45-5455, which raises a KeyError 
exception. 

14-6.3 Deleting Items 

To delete an item from a dictionary, use the syntax: 
del dicti onaryName[key] 

For example: 

del students ['234-56-9010"] 

This statement deletes an item with the key 234-56-9010 from the dictionary. If the key 
is not in the dictionary, a KeyError exception is raised. 

14-6-4 Looping Items 

You can use a for loop to traverse all keys in the dictionary. For example: 


1 »> students = {"111-34-3434":"John", "132-56-6290":"Peter"} 

2 »> for key in students: 

3 ... printfkey -i -t- str(students[key])) 

4 ... 

5 "111-34-3434":"John" 

6 "132-56-6290":"Peter" 

7 »> 



The for loop iterates on keys in dictionary students (line 2). students [key] returns the 
value for the key (line 3). 
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lenCdictionary) 


in operator 


14-6.5 The 1 en Function 

You can find the number of the items in a dictionary by using len(dictionary). For 
example: 




In line 2, 1 enCstudents) returns the number of items in dictionary students. 

14-6.6 Testing Whether a Key Is in a Dictionary 

You can use the i n or not 1 n operator to determine whether a key is in the dictionary. For 
example: 




In line 2, "111-34-3434" in students checks whether the key 111-34-3434 is in 
dictionary students. 

14-6.7 Equality Test 

You can use the == and ! = operators to test whether two dictionaries contain the same items. 
For example: 




»> 

dl = 

{"red" 

41, 

"bl ue 

':3} 

»> 

d2 = 

{"blue 

':3, 

" red" 

41} 

»> 

dl = 

- d2 




T rue 





»> 

dl 

= d2 




Fal se 





»> 







1 

»> students = {"111-34-3434":"John", 

"132-56-6290":"Peter"} 

2 

»> "111-34-3434" in students 


3 

T rue 


4 

»> "999-34-3434" in students 


5 

Fal se 


6 

»> 



1 »> students = {"111-34-3434":"John", "132-56-6290":"Peter"} 

2 »> Jen(students) 

3 2 

4 »> 


In this example, dl and d2 contain the same items regardless of the order of the items in a 
dictionary. 



Note 

You cannot use the comparison operators (>, >=, <=, and <) to compare dictionaries 
because the items are not ordered. 








14-6.8 The Dictionary Methods 

The Python class for dictionaries is diet. Figure 14.2 lists the methods that can be invoked 
from a dictionary object. 
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diet 



keys(): tuple 


Returns a sequence of keys. 

valuesf): tuple 


Returns a sequence of values. 

iterns(): tuple 


Returns a sequence of tuples. Each tuple is (key, value) for an item. 

clear(): None 


Deletes all entries. 

get(key): value 


Returns the value for the key. 

pop(key): value 


Removes the item for the key and returns its value. 

popitemO: tuple 


Returns a randomly selected key/value pair as a tuple and removes 
the selected item. 


Figure 14-2 The diet class provides methods for manipulating a dictionary object. 


The getCkey) method is similar to dietionaryName[key] except that the get method 
returns None if the key is not in the dictionary rather than raising an exception. The 
pop(key) method is the same as del dietionaryName[key] . 

Here are some examples that show these methods in use: 


1 »> students = {"111-34-3434":"lohn", "132-56-6290":"Peter"} 

2 »> tupl efstudents. keysO) 

3 ("111-34-3434", "132-56-6290") 

4 »> tuplefstudents.valuesO) 

5 ("John", "Peter") 

6 »> tuple(students.items()) 

7 (("111-34-3434", "John"), ("132-56-6290", "Peter")) 

8 »> students.get("lll-34-3434") 

9 "John" 

10 »> print(students.get("999-34-3434")) 

11 None 

12 »> students.pop("lll-34-3434") 

13 "John" 

14 »> students 

15 {"132-56-6290":"Peter"} 

16 »> students. cl ear() 

17 »> students 

18 {} 

19 »> 


The dictionary students is created in line 1, and students. keys() in line 2 returns the 
keys in the dictionary. In line 4, students.vaJuesC) returns the values in the dictionary, 
and students. i tems() in line 6 returns items as tuples in the dictionary. In line 10, invok¬ 
ing students.get("999-34-3434") returns the student name for the key 999-34-3434. 
Invoking students.pop("lll-34-3434") in line 12 removes the item in the dictionary 
with the key 111-34-3434. In line 16, invoking students. cl ear () removes all items 
from the dictionary. 
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14.18 How do you create an empty dictionary? 

14.19 Which of the following dictionaries are created correctly? 

d = {1:[1, 2], 3:[3, 4]} 
d = {[1, 2]:1, [3, 4]:3} 
d = {(1, 2):1, (3, 4):3} 
d = {l:"john", 3: "peter"} 
d = {"john":l, "peter": 3} 

14.20 Each item in a dictionary has two parts. What are they called? 

14 . 2 1 Suppose a dictionary named students is {"John" : 3, "peter" : 2}. What do the 
following statements do? 

(a) students["susan"] = 5 

(b) students["peter"] = 5 

(c) students["peter"] += 5 

(d) del students["peter"] 

14.22 Suppose a dictionary named students is {" john" : 3, "peter" : 2}. What do the 
following statements do? 

(a) print(len(students)) 

(b) printCstudents.keysO) 

(c) printCstudents.valuesO) 

(d) printCstudents.itemsO) 

14.23 Show the output of the following code: 
def mai n(): 

d = {"red":4, "blue":l, "green":14, "yellow":2} 

print(d ["red"] ) 

print(list(d.keys())) 

print(listCd.values())) 

printC'blue" in d) 

pri ntC'purple" in d) 

d["blue"] += 10 

pri nt(d ["blue' ]) 


mainO # Call the main function 

14.24 Show the output of the following code: 
def mai n(); 
d = {} 

d["susan"] = 50 
d["jim'] = 45 
d["joan"] = 54 
d["susan"] = 51 
d['john"] = 53 
print(len(d)) 


mainO # Call the main function 

14.25 For a dictionary d, you can use d[key] or d.getCkey) to return the value for the 
key. What are the differences between them? 


/r/Key 

»P / Point 


14.7 Case Study: Occurrences of Words 

This case study writes a program that counts the occurrences of words in a text file 
and displays ten most frequently used words in decreasing order of their occurrence 
counts. 
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The program in this case study uses a dictionary to store an item consisting of a word and its 
count. The program determines whether each word is already a key in the dictionary. If not, 
the program adds a dictionary item with the word as the key and the value 1. Otherwise, the 
program increases the value for the word (key) by 1 in the dictionary. Assume the words are 
case-insensitive (for example. Good is treated the same as good). The program displays the 
ten most frequently used words in the file in decreasing order of their count. 

Listing 14.5 shows the solution to the problem. 


Listing 14-5 CountOccurrenceOfWords. py 


1 def mai n () : 

2 # Prompt the user to enter a file 

3 filename = input("Enter a filename: ")-strip() 

4 infile = open(fi1ename, 'r") # Open the file 

5 

6 wordCounts = {} # Create an empty dictionary to count words 

7 for line in infile: 

8 processLine(line.lowerO, wordCounts) 

9 

10 pairs = list(wordCounts.items()) # Get pairs from the dictionary 

11 

12 items = [[x, y] for (y, x) in pairs] # Reverse pairs in the list 

13 

14 items.sortO # Sort pairs in items 

15 

16 for i in range(len(items) - 1, len(items) - 11, -1): 

17 print(items[i] [1] + "\t" + str(items[i] [0])) 

18 

19 # Count each word in the line 

20 def processLine(line, wordCounts): 

21 line = replacePunctuations(line) # Replace punctuation with space 

22 words = line.splitO # Get words from each line 

23 for word in words: 

24 if word in wordCounts: 

25 wordCounts[word] += 1 

26 else: 

27 wordCounts[word] = 1 

28 

29 # Replace punctuation in the line with a space 

30 def replacePunctuations(line): 

31 for ch in line: 

32 if ch in ^-@#$%a&*() |'V'" : 

33 line = 1ine.replace(ch, ) 

34 

35 return line 

36 

37 mainO # Call the main function 


enter a file 
open file 

create a dictionary 
process each line 
get pairs to list 
reverse pair 


display item 
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extract words 

increase word count 
new word 
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The program prompts the user to enter a filename (line 3) and opens the file (line 4). It cre¬ 
ates a dictionary wordCounts (line 6) to store pairs of words and their occurrence counts. 
The words serve as the keys. 

The program reads each line from the file and invokes processLineCl ine, wordCounts) 
to count the occurrence of each word in the line (lines 7-8). Suppose the wordCounts dictionary 
is {"red" : 7, "blue": 5, "green" : 2}. How do you sort it? The dictionary object does not 
have the sort method. But the list object has it, so you can get the pairs into a list and then sort 
that list. The program obtains the list of pairs in line 10. If you apply the sort method to the list, 
sort pairs the pairs will be sorted on their first element, but we need to sort each pair on their count (the 

second element). How can we do this? The trick is to reverse the pair. The program creates a new 
list with all the pairs reversed (line 12), and then applies the sort method (line 14). Now the list 
is sorted like this: [[2, "green"], [5, "blue"], [7, "red"]]. 

The program displays the last ten pairs from the list to show the words with the highest 
count (lines 16-17). 

processLine The processLine(l ine, wordCounts) function invokes replacePunctuationsCl ine) 

to replace all punctuation marks by spaces (line 21), then extracts words by using the spl it 
method (line 22). If a word is already in the dictionary, the program increases its count (line 
25); otherwise, the program adds a new pair to the dictionary (line 27). 
replacePunctuations (line) The repl acePunctuations(l ine) method checks each character in each line. If it is a 

punctuation mark, the program replaces it with a space (lines 32-33). 

Now sit back and think how you would write this program without using a dictionary. You 
could use a nested list such as [ [keyl, valuel], [key2, value2], ... ], but your 
new program would be longer and more complex. You will find that a dictionary is a very 
efficient and powerful data structure for solving problems such as this. 
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Chapter Summary 


1. A tuple is a fixed list. You cannot add, delete, or replace elements in a tuple. 

2 . Since a tuple is a sequence, the common operations for sequences can be used for 
tuples. 

3 . Though you cannot add, delete, or replace elements in a tuple, you can change the 
content of individual elements if the elements are mutable. 

4. A tuple is immutable if all its elements are immutable. 
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5. Sets are like lists in that you use them for storing a collection of elements. Unlike 
lists, however, the elements in a set are nonduplicates and are not placed in any par¬ 
ticular order. 

6. You can add an element to a set using the add method and remove an element from 
the list using the remove method. 

7. The 1 en, min, max, and sum functions can be applied to a set. 

8 . You can use a for loop to traverse the elements in a set. 

9. You can use the issubset or issuperset method to test whether a set is a subset 
or a superset of another set, and use the | and A operators to perform set union, 
intersection, difference, and symmetric difference. 

10. Sets are more efficient than lists for testing whether an element is in a set or a list as 
well as for removing elements from a set or a list. 

11. A dictionary can be used to store key/value pairs. You can retrieve a value using a key. 
The keys are like an index operator. In a list, the indexes are integers. In a dictionary, 
the keys can be any hashable objects such as numbers and strings. 

12. You can use dictionaryName[key] to retrieve a value in the dictionary for the 
given key and use dictionaryName[key] = val ue to add or modify an item in a 
dictionary. 

13. You can use del dictionaryName[key] to delete an item for the given key. 

14. You can use a for loop to traverse all keys in a dictionary. 

15. You can use the 1 en function to return the number of items in a dictionary. 

16. You can use the i n and not i n operators to test if a key is in a dictionary and use the 
== and ! - operator to test if two dictionaries are the same. 

17. You can use the methods keys(), valuesO, i terns (), clearC), get (key), 
pop (key), and popitemC) on a dictionary. 

Test Questions 

Do test questions for this chapter online at www.cs.armstrong.edu/liang/py/test.html. 
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Sections 14.2-14.6 

14.1 {Display keywords) Revise Listing 14.4 CountKeywords.py to display the key¬ 
words in a Python source file as well as to count the number of the keywords. 

14.2 {Count occurrences of numbers) Write a program that reads an unspecified num¬ 
ber of integers and finds the ones that have the most occurrences. For example, if 
you enter 23 40 354-3332 0, the number 3 occurs most often. Enter all num¬ 
bers in one line. If not one but several numbers have the most occurrences, all of 
them should be reported. For example, since 9 and 3 appear twice in the list 9 30 
3 9 3 2 4, both occurrences should be reported. 
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Figure 14-3 


*14-3 (Count the occurrences of each keyword) Write a program that reads in a Python 
source code file and counts the occurrence of each keyword in the file. Your pro¬ 
gram should prompt the user to enter the Python source code filename. 

* 14-4 (Tkinter: Count the occurrences of each letter) Rewrite Listing 14.5 using a GUI 
program to let the user enter the file from an entry field, as shown in Figure 14.3a. 
You can also select a file by clicking the Browse button to display an Open file dia¬ 
log box, as shown in Figure 14.3b. The file selected is then displayed in the entry 
field. Clicking the Show Result button displays the result in a text widget. You 
need to display a message in a message box if the file does not exist. 


7^ Occurrence of Letters 


a appears 

102 times 


b appears 

14 times 


c appears 

31 times 


d appears 

5S tim.es 


e appears 

165 tim.es 

1 

f appears 

27 timies 

1 

g appears 

2S tim.es 

1 

h appears 

SO tim.es 

1 

i appears 

6S timies 

1 

k appears 

3 tim.es 

1 

Enter a filename 

c:\pybook\Lincoln.tx^ 

Browse | Show Result | 



(a) (b) 

The program lets the user select a file and displays the occurrence counts of the letters in the file. 


* 14-5 (Tkinter: Count the occurrences of each letter) Revise the preceding exercise to 
display a histogram for the result, as shown in Figure 14.4. You need to display a 
message in a message box if the file does not exist. 


m. 


abcdefgh ij k Imnopqr stuvwxyz 
Enter a filename: c:\pybook\Lincoln.tx^ Browse Show Result 


Figure 14-4 The program lets the user select a file and displays the occurrence counts in a 
histogram. 


* 14-6 (Tkinter: Count the occurrences of each letter) Rewrite Listing 14.5 using a GUI 
program to let the user enter the URL from an entry field, as shown in Figure 14.5. 
Clicking the Show Result button displays the result in a text widget. You need to 
display a message in a message box if the URL does not exist. 
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Figure 14-5 The program lets the user enter a URL for a file and displays the occurrence 
counts of the letters in the file. 


*14-7 {Tkinter: Count the occurrences of each letter) Revise the preceding exercise to 
display a histogram for the result, as shown in Figure 14.6. You need to display a 
message in a message hox if the URL does not exist. 


\ ^ Occurrence of LettersJnaHistogt^n^romUR^ 





Enter a URL: |http:/7c5.armstrong.edu/liang/data/Lincoln.tx^ 


Show Result 


Figure 14-6 The program lets the user enter a URL for a file and displays the occurrence 
counts of the letters in a histogram. 


14-8 {Display nonduplicate words in ascending order) Write a program that prompts 
the user to enter a text file, reads words from the file, and displays all the nondu¬ 
plicate words in ascending order. 

***14-9 {Game: hangman) Write the hangman game with a graphics display, as shown in 
Figure 14.7. After seven misses, the program displays the word. The user can 
press the Enter key to continue to guess another word. 


*14*10 {Guess the capitals) Rewrite Exercise 11.40 using a dictionary to store the pairs 
of states and capitals so that the questions are randomly displayed. 

*14*1 I {Count consonants and vowels) Write a program that prompts the user to enter a 
text filename and displays the number of vowels and consonants in the file. Use 
a set to store the vowels A, E, I, 0, and U. 
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*74 [ czn Q 


'7ii ^ [■<=»-(4=1- 


1 lanc^nian ^ ^ 













1 





Guess a word: ♦**♦*♦* 



Guess a word: r++*+''‘* 



Guess a word: r****** 





Missed letters: t 


r 

\ Missed lellers: Ip 



74 Hangman ^ [cr>; Q 


Guess a word; r****'** 1 

'N, Missed letters: tpqo | 



7i Hangman 


t he word is: reeewe 

To^jontinue the eame. press ENTER 


Figure 14-7 The hangman game lets the user enter letters to guess a word. 





























































































CHAPTER 


15 

Recursion 

objectives 

■ To explain what a recursive function is and describe the benefits of using 
recursion (§15.1). 

■ To develop recursive programs for recursive mathematical functions 
(§§15.2-15.3). 

■ To explain how recursive function calls are handled in a call stack 
(§§15.2-15.3). 

■ To solve problems using recursion (§15.4). 

■ To use a helper function to design a recursive function (§15.5). 

■ To implement a selection sort using recursion (§15.5.1). 

■ To implement a binary search using recursion (§15.5.2). 

■ To get a directory’s size using recursion (§15.6). 

■ To solve the Towers of Hanoi problem using recursion (§15.7). 

■ To draw fractals using recursion (§15.8). 

■ To solve the Eight Queens problem using recursion (§15.9). 

■ To explain the relationship and differences between recursion and iteration 
(§15.10). 

■ To understand tail-recursive functions and explain why 
they are desirable (§15.11). 
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15.1 Introduction 


rr/Key 
r /'Point 


Recursion is a technique that leads to elegant solutions to problems that are difficult to 
program using simple loops. 


seaich word problem Suppose you want to find all the files in a directory that contain a particular word. How do 

you solve this problem? There are several ways to do so. An intuitive and effective solution is 
to use recursion by searching the files in each subdirectory recursively. 

H-tree problem The H-tree shown in Figure 15.1 is used in a very large-scale integration (VLSI) design as 

a clock distribution network for routing timing signals to all parts of a chip with equal propa¬ 
gation delays. How do you write a program to display the H-tree? A good approach is to use 
recursion by exploring the recursive pattern. 




(a) (b) 


I I 


H 

H 


H H 
M M 


H H H H 


H 

M 


Cnter dn order 


2| Disploy 


(c) 



(d) 


Figure 15.1 An H-tree can be displayed using recursion. 


recursive function To use recursion is to program by using recursive functions —functions that invoke them¬ 

selves. Recursion is a useful programming technique. In some cases, it enables you to develop 
a natural, straightforward, simple solution to an otherwise difficult problem. This chapter 
introduces the concepts and techniques of recursive programming and presents examples that 
show you how to “think recursively.” 


tr/Key 
V ? Point 


15.2 Case Study: Computing Factorials 

A recursive function is one that invokes itself. 

Many mathematical functions are defined using recursion. Let’s begin with a simple example. 
The factorial of a number n can be recursively defined as follows: 



VideoNote 

Function sum 


base case or stopping 
condition 


recursive call 


0! = 1; 

n! =nx(n-l)!; n>0 

How do you find n! for a given n? To find 1 ! is easy, because you know that 0! is 1, and 
1 ! is 1 X 0! . Assuming that you know (n - 1) ! , you can obtain n ! immediately by using 
n X (n - 1) ! . Thus, the problem of computing n! is reduced to computing (n - 1) ! . 
When computing (n - 1) ! , you can apply the same idea recursively until n is reduced to 0. 

Let factor 1 al (n) be the function for computing n! . If you call the function with n = 0, 
it immediately returns the result. The function knows how to solve the simplest case, which is 
referred to as the base case or the stopping condition. If you call the function with n > 0, it 
reduces the problem into a subproblem for computing the factorial of n - 1. The subproblem 
is essentially the same as the original problem, but it is simpler or smaller. Because the sub¬ 
problem has the same property as the original problem, you can call the function with a 
different argument, which is referred to as a recursive call. 
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The recursive algorithm for computing factorial (n) can be simply described as 
follows: 

if n == 0 : 

return 1 
else: 

return n * factorial(n - 1 ) 

A recursive call can result in many more recursive calls, because the function keeps on 
dividing a subproblem into new subproblems. For a recursive function to terminate, the 
problem must eventually be reduced to a stopping case, at which point the function returns a 
result to its caller. The caller then performs a computation and returns the result to its own 
caller. This process continues until the result is passed back to the original caller. The origi¬ 
nal problem can now be solved by multiplying n by the result of factori al (n - 1) . 

Listing 15.1 is a complete program that prompts the user to enter a nonnegative integer and 
displays the factorial for the number. 

Listing 15.1 ComputeFactorial .py 

1 def mai n () : 

2 n = eval(i nputC'Enter a nonnegative integer: ")) 

3 printC'Factorial of", n, "is", factor!al (n) ) 

4 

5 # Return the factorial for the specified number 

6 def factor!al(n): 

7 if n == 0: # Base case 

8 return 1 

9 el se : 

10 return n * factor!al(n - 1) # Recursive call 

11 

12 mainO # Call the main function 


Enter a nonnegative integer: 
Factorial of 4 is 24 

4 



Enter a nonnegative integer: 
Factorial of 10 is 3628800 

10 l^^nteTj 


The factorial function (lines 6-10) is essentially a direct translation of the recursive 
mathematical definition for the factorial into Python code. The call to factorial is recursive 
because it calls itself. The parameter passed to factorial is decremented until it reaches the 
base case of 0. 

Now that you have seen how to write a recursive function, let’s see how recursion works. 
Figure 15.2 illustrates the execution of the recursive calls, starting with n = 4. The use of 
stack for recursive calls is shown in Figure 15.3. 

Pedagogical Note 

It is simpler and more efficient to implement the factorial function by using a loop. 
However, we use the recursive factorial function here to demonstrate the concept of 
recursion. Later in this chapter, we will present some problems that are inherently recur¬ 
sive and are difficult to solve without using recursion. 



base case 


recursion 


■fg. 



how does it work? 
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Step 9: return 24 


Step 8: return 6 


factorial (4) 

Step 0: execute factor! al (4) 


I--1 

return 4 * factorial (3) 


Step 1; execute factor! al (3) 


I--1 

return 3 * factorial (2) 


Step 7: return 2 


Step 2: execute factor! al (2) 


Step 6: return 1 


return 2 * factor! al(l) 

Step 3: execute factor! al (1) 


return 1 * factor! al(0) 

Step 4: execute factor! al (0) 


Step 5: return 1 


return 1 

Figure 15.2 Invoking factorial (4) spawns recursive calls to factorial . 












5 

Space required 
for factor! al (0) 
n: 0 

4 

Space required 
for factor!al (1) 
n: 1 

Space required 
for factor! al (1) 
n: 1 

3 

Space required 
for factor! al (2) 
n: 2 

Space required 
for factor!al (2) 
n: 2 

Space required 
for factor! al (2) 
n: 2 

2 

Space required 
for factorial (3) 
n: 3 

Space required 
for factor! al (3) 
n: 3 

Space required 
for factor!al (3) 
n: 3 

Space required 
for factor! al (3) 
n: 3 

1 

Space required 
for factorial (4) 
n: 4 

Space required 
for factor! al (4) 
n: 4 

Space required 
for factor! al (4) 
n: 4 

Space required 
for factor! al (4) 
n: 4 

Space required 
for factor! al (4) 
n: 4 










6 

Space required 
for factorial (1) 
n: 1 

Space required 
for factorial (2) 
n: 2 

7 

Space required 
for factorial (2) 
n: 2 

Space required 
for factor! al (3) 
n: 3 

Space required 
for factor! al (3) 
n: 3 

8 

Space required 
for factor! al (3) 
n: 3 

Space required 
for factorial (4) 
n: 4 

Space required 
for factorial (4) 
n: 4 

Space required 
for factor! al (4) 
n: 4 

9 

Space required 
for factor! al (4) 
n: 4 


Figure 15.3 When factorial (4) is being executed, the factorial function is called recursively, causing stack 
space to dynamically change. 
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If recursion does not reduce the problem in a manner that allows it to eventually converge 
into the base case, infinite recursion can occur. For example, suppose you mistakenly write infinite recursion 
the factorial function as follows: 

def factor!al (n): 

return n * factorial(n - 1) 

The function runs infinitely and causes a RuntimeError. 

The example discussed so far shows a recursive function that invokes itself. This is known 
as direct recursion. It is also possible to create indirect recursion. This occurs when function direct recursion 

A invokes function B, which in turn invokes function A. There can even be several more func- indirect recursion 

tions involved in the recursion. For example, function A invokes function B, which invokes 
function C, which invokes function A. 

15.1 What is a recursive function? 

15.2 How many times would the factorial function in Listing 15.1 be invoked for 

factorial(6)7 

15.3 Write a recursive mathematical definition for computing 2" for a positive integer n. 

1 5.4 Write a recursive mathematical definition for computing x” for a positive integer n 
and a real number x. 

15.5 Write a recursive mathematical definition for computing 1 + 2 + 3 + . . . + nfor 
a positive integer. 

15.6 What is an infinite recursion? What is a direct recursion? What is an indirect recursion? 

15.3 Case Study: Computing Fibonacci Numbers 

In some cases, recursion enables you to create an intuitive, straightforward, simple 
solution to a problem. 

The factorial function in the preceding section could easily be rewritten without using 
recursion. In this section, we show an example for creating an intuitive, straightforward, sim¬ 
ple solution to a problem using recursion that would otherwise be difficult to solve. Consider 
the well-known Fibonacci-series problem: 

The series: 0 1 1 2 3 5 8 13 21 34 55 89 .. . 

indexes: 01234567 8 9 10 11 

The Fibonacci series begins with 0 and 1, and each subsequent number is the sum of the 
preceding two. The series can be recursively defined as follows: 

fib(O) = 0 
fib(l) = 1 

fib(index) = fibfindex - 2) + fibfindex - 1); index >= 2 

Note 

The Fibonacci series was named for Leonardo Fibonacci, a medieval mathematician who 
originated it to model the growth of the rabbit population. It can be applied in numeric 
optimization and in various other areas. 

How do you find fibCindex) for a given index? It is easy to find fibC2), because you 
know fib(O) and fib(l). Assuming that you know fib(index - 2) and fibCindex - 
1), you can obtain fibCindex) immediately. Thus, the problem of computing fibCindex) 
is reduced to computing fibCindex 2) and fibCindex - 1). When doing so, you 
apply the idea recursively until i ndex is reduced to 0 or 1 . 
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The base case is i ndex = 0 or index = 1. If you call the function with index = 0 or 
index - 1, it immediately returns the result. If you call the function with index >= 2, it 
divides the problem into two subproblems for computing fibCindex - 1) and fib(index 
- 2) using recursive calls. The recursive algorithm for computing fibCindex) can be sim¬ 
ply described as follows: 

if index == 0 : 

return 0 

el if index == 1 : 

return 1 

el se: 

return fibCindex - 1) + fibCindex - 2) 

Listing 15.2 is a complete program that prompts the user to enter an index and computes 
the Fibonacci number for that index. 


Listing 15.2 ComputeFi bonacci. py 

1 def mai n O : 

2 index = evalCi nputC'Enter an index for a Fibonacci number: )) 

3 # Find and display the Fibonacci number 

4 printC'The Fibonacci number at index", index, ’is", fibCindex)) 

5 

6 # The function for finding the Fibonacci number 

7 def fibCindex): 


base case 

8 

if index == 0: # Base case 


9 

return 0 

base case 

10 

el if index == 1: # Base case 


11 

return 1 


12 

else: # Reduction and recursive calls 

recursion 

13 

return fibCindex - 1) + fibCindex 


14 



15 

mainC) # Call the main function 



Enter an index for a Fibonacci number: 1 Enter 
The Fibonacci number at index 1 is 1 



Enter an index for a Fibonacci number: 6 Enter 
The Fibonacci number at index 6 is 8 



Enter an index for a Fibonacci number: 7 
The Fibonacci number at index 7 is 13 


The program does not show the considerable amount of work done behind the scenes by 
the computer. Figure 15.4, however, shows the successive recursive calls for evaluating 
fibC4). The original function, fibC4), makes two recursive calls, fib(3) and fibC2), 
and then returns fibC3) + fib(2). But in what order are these functions called? In 
Python, operands are evaluated from left to right, so fib(2) is called after fib(3) is 
completely evaluated. The labels in Figure 15.4 show the order in which the functions 
are called. 
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fib(4) 




- return 1 i i ueu.. '—'return 0 

Figure 15.4 Invoking f1b(4) spawns recursive calls to fib. 


As shown in Figure 15.4, there are many duplicated recursive calls. For instance, fibC2) 
is called twice, fibCl) three times, and fib(O) twice. In general, computing fibCindex) 
requires roughly twice as many recursive calls as does computing f i b ( i ndex - 1) . As you 
try larger index values, the number of calls substantially increases, as shown in Table 15.1. 


Table 15.1 Number of Recursive Calls in fib(n) 

n 2 3 4 10 20 30 40 50 

# of calls 3 5 9 177 21891 2692537 331160281 2075316483 



Pedagogical Note 

The recursive implementation of the fib function is very simple and straightforward, but it 
isn't efficient. See Programming Exercise 15.2 for an efficient solution using loops. Though it is 
not practical, the recursive fib function is a good example of howto write recursive functions. 


15.7 How many times would the fib function in Listing 15.2 be invoked for fib(6)? 

15.8 Show the output of the following programs and identify their base cases and recursive 
calls. 


def f(n) : 


def f(n): 

if n == 1: 


if n > 0: 

return 1 


printfn % 10) 

else: 


f(n // 10) 

return n + f(n - 1) 


fCl234567) 

printC'Sum is", fC5)) 




/Check 
V Point 

MyProgrammingLab" 


15.4 Problem Solving Using Recursion 

If you think recursively, many problems can be solved using recursion. 

The preceding sections presented two classic recursion examples. All recursive functions 
have the following characteristics: 


r:/Key 
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recursion characteristics 


■ The function is implemented using an i f-el se or a swi tch statement that leads to i f-el se 
different cases. 


One or more base cases (the simplest case) are used to stop recursion. 


base cases 
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reduction 


think recursively 
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Function print numbers 

recursive call 


think recursively 


function header 
base case 

base case 


■ Every recursive call reduces the original problem, bringing it increasingly closer to a 
base case until it becomes that case. 

In general, to solve a problem through recursion, you break it into subproblems. Each sub¬ 
problem is almost the same as the original problem, but it is smaller in size. You can apply the 
same approach to each subproblem to solve it recursively. 

Recursion is everywhere. It is fun to think recursively. Consider drinking coffee. You can 
describe the procedure recursively, as follows: 

def d rinkCoffee(cup): 
if cup is not empty: 

cup.takeOneSipO # Take one sip 
drinkCoffee(cup) 

Assume cup is an object for a cup of coffee with the instance functions isEmptyC) and 
takeOneSipC). You can break the problem into two subproblems: one is to drink one sip of 
coffee, and the other is to drink the rest of the coffee in the cup. The second problem is the 
same as the original problem but smaller in size. The base case for the problem is when the 
cup is empty. 

Consider the problem of printing a message n times. You can break the problem into two 
subproblems: one is to print the message one time, and the other is to print it n - 1 times. The 
second problem is the same as the original problem but it is smaller in size. The base case for 
the problem is n == 0. You can solve this problem using recursion as follows: 

def nPrintlnfmessage, n) : 
if n >= 1: 

print(message) 
nPrintIn(message, n - 1) 

# The base case is n == 0 

Note that the fib function in the preceding section returns a value to its caller, but the 
nPri ntl n function is void and does not. 

If you think recursively, you can use recursion to solve many of the problems presented in 
earlier chapters of this book. Consider the palindrome problem in Listing 8.1. Recall that a 
string is a palindrome if it reads the same from the left and from the right. Eor example, 
“mom” and “dad” are palindromes, but “uncle” and “aunt” are not. The problem of determin¬ 
ing whether a string is a palindrome can be divided into two subproblems: 

■ Determine whether the first character and the last character of the string are equal. 

■ Ignore the two end characters and see if the rest of the substring is a palindrome. 

The second subproblem is the same as the original problem but smaller in size. There are 
two base cases: (1) the two end characters are not the same, and (2) the string size is 0 or 1. In 
case 1, the string is not a palindrome; in case 2, the string is a palindrome. The recursive func¬ 
tion for this problem can be implemented as shown in Listing 15.3. 


Listing 15.3 Recursi vePal i ndromeUsi ngSubstri ng. py 

1 def IsPalindrome(s): 

2 if len(s) <= 1: # Base case 

3 return True 

4 elif s[ ] != s[len(s) - 1] : # Base case 

5 return False 

6 el se : 

7 return isPalindrotne(s [1 : len(s) - 1]) 

8 


recursive call 


15.5 Recursive Helper Functions 507 


9 def mai n () : 

10 printC'Is 

11 printC'Is 

12 printC'Is 

13 printC'Is 

14 printC'Is 

15 

16 mainO # Cali 


moon a palindrome?", isPali ndromeC'moon")) 
noon a palindrome?", isPali ndromeC'noon")) 
a a palindrome?", isPalindromeC'a")) 
aba a palindrome?", isPali ndrome("aba")) 
ab a palindrome?', isPal indromeC'ab")) 

the main function 


Is moon a palindrome? False 
Is noon a palindrome? True 
Is a a palindrome? True 
Is aba a palindrome? True 
Is ab a palindrome? False 



The string slicing operator in line 7 creates a new string that is the same as the original 
string except without the first and last characters. Checking whether a string is a palindrome 
is equivalent to checking whether the substring is a palindrome if the two end characters in the 
original string are the same. 

15.9 Describe the characteristics of recursive functions. ^ 

/Check 

15.10 Show the call stacks for isPal indrome("abcba") using the functions defined in v Point 

Listing 15.3. MyProgrammingLab" 

15.11 Show the output of the following two programs: 


def f(n) : 


def f(n): 

if n > 0: 


if n > 0: 

printfn, end = ) 


f(n - 1) 

f(n - 1) 


printfn, end = ') 

f(5) 


f(5) 


15.12 What is wrong in the following function? 


def f(n) : 

if n != 0 : 

print(n, end = ' ') 
f(n / 10) 

fC1234567) 


15.5 Recursive Helper Functions 

Sometimes you can find a recursive solution by slightly changing the original problem 
This new function is called a recursive helper function. The original problem can be 
solved by invoking the recursive helper function. 

The preceding recursive i sPal 1 ndrome function is not efficient, because it creates a new string 
for every recursive call. To avoid creating new strings, you can use the low and high indexes to 
indicate the range of the substring. These two indexes must be passed to the recursive function. 
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helper function 
base case 

base case 


recursive helper function 


helper function 
base case 


Since the original function is isPalindromeCs), you have to create the new function 
isPalindromeHelperCs, low, high) to accept additional information on the string, as 
shown in Listing 15.4. 

Listing 15.4 RecursivePalindrome.py 

1 def isPalindrome(s): 

2 return isPalindromeHelperCs, 0, len(s) - 1) 

3 

4 def isPalindromeHelperCs, low, high): 

5 if high <= low : # Base case 

6 return True 

7 el if s[low] != s[high] : # Base case 

8 return False 

9 el se : 

10 return isPalindromeHelperCs, low + 1, high - 1) 

11 

12 def mainC): 

13 printC’Ts moon a palindrome?'', isPali ndromeC'moon")) 

14 printC'Is noon a palindrome?'', isPalindromeC "noon")) 

15 printC'Is a a palindrome?", isPali ndromeC'a")) 

16 printC'Is aba a palindrome?", isPali ndromeC'aba")) 

17 printC'Is ab a palindrome?", isPali ndromeC'ab")) 

18 

19 mainC) # Call the main function 

The isPalindromeCs) function checks whether a string s is a palindrome, and the 
isPalindromeHelperCs, low, high) function checks whether a substring s[low . 
high + 1] is a palindrome. The isPal indromeCs) function passes the string s with low 
= 0 and high = lenCs) - 1 to the isPalindromeHelper function, which can be 
invoked recursively to check a palindrome in an ever-shrinking substring. It is a common 
design technique in recursive programming to define a second function that receives addi¬ 
tional parameters. Such a function is known as a recursive helper function. 

Helper functions are very useful in designing recursive solutions for problems involving 
strings and lists. The sections that follow give two more examples. 

15.5.1 Selection Sort 

Selection sort was introduced in Section 10.11.1. Recall that it finds the smallest element in a 
list and swaps it with the first element. It then finds the smallest element remaining and swaps 
it with the first element in the remaining list, and so on until the remaining list contains only a 
single element. The problem can be divided into two subproblems: 

■ Find the smallest element in the list and swap it with the first element. 

■ Ignore the first element and sort the remaining smaller list recursively. 

The base case is that the list contains only one element. Listing 15.5 gives the recursive 
sort function. 

Listing 15.5 RecursiveSelectionSort.py 

1 def sort(lst): 

2 sortHelper(lSt, 0, len(lst) - 1) # Sort the entire list 

3 

4 def sortHelper(lSt, low, high): 

5 if low < high: 

6 # Find the smallest element and its index in 1st[low .. high] 

7 indexOfMin = low 
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8 min = 1st [low] 

9 for i in range(low + 1, high + 1): 

10 if lst[i] < min: 

11 min = 1st [i] 

12 indexOfMin = i 

13 

14 # Swap the smallest in 1st[low .. high] with 1st[low] 

15 1 St[indexOfMin] = 1st[low] 

16 1st[low] = min 

17 

18 # Sort the remaining lst[low+l .. high] 

19 sortHelper(lSt, low + 1, high) 

20 

21 def mainO : 

22 1st = [3, 2, 1, 5, 9, 0] 

23 sort(lst) 

24 print(lst) 

25 

26 mainO # Call the main function 


recursive call 


The sort(lst) function sorts a list in lst[0. .len(lst) - 1] and the 

sortHel per(l St, low, high) function sorts a sublist in 1 st[low. .high]. The second 
function can be invoked recursively to sort an ever-shrinking sublist. 


15.5.2 Binary Search 

Binary search was introduced in Section 10.10.2. For a binary search to work, the elements in 
the list must already be ordered. The binary search first compares the key with the element in 
the middle of the list. Consider the following three cases: 

■ Case 1: If the key is less than the middle element, the program recursively searches 
for the key in the first half of the list. 

■ Case 2: If the key is equal to the middle element, the search ends with a match. 

■ Case 3: If the key is greater than the middle element, the program recursively 
searches for the key in the second half of the list. 

Case 1 and Case 3 reduce the search to a smaller list. Case 2 is a base case when there is a 
match. Another base case is that the search is exhausted without a match. Listing 15.6 gives a 
simple solution for the binary search problem using recursion. 

Listing 15.6 Recursi veBi narySearch. py 

1 def recursiveBinarySearchflst, key): 

2 low = 0 

3 high = ienflst) - 1 

4 return recursiveBinarySearchHelperflst, key, low, high) 

5 


6 

def recursiveBinarySearchHe]per(]st, key, low, high) 


helper function 

7 

if low > high: # The list has been exhausted without a match 

base case 

8 

9 

10 

return -low - 1 



mid = (low + high) // 2 



11 

if key < 1st[mid]: 



12 

return recursiveBinarySearchHelper(lst, key. 

low, mid - 1) 

recursive call 

13 

el if key == 1st[mid]: 


base case 

14 

return mid 



15 

el se : 



16 

return recursiveBinarySearchHelper(lst, key. 

mid + 1, high) 

recursive call 
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17 





18 

def mainO : 




19 

1st = [3, 

5, 6, 8, 

9. 12, 34, 36] 


20 

printfrecursiveBinarySearch(lst, 

3)) 

21 

printfrecursiveBinarySearch(lst, 

4)) 

22 





23 

mainO # Call 

the main 

function 



The recursiveBinarySearch function finds a key in the whole list (lines 1^). The 
recursiveBinarySearchHelper function finds a key in the list with the index from low 
to high (lines 6-16). 

The recursiveBinarySearch function passes the initial list with low = 0 (line 2) and 
high = len(lst) - 1 (line 3) to the recursiveBinarySearchHelper function, which 
is invoked recursively to find the key in an ever-shrinking sublist. 


/Check 

Point 

MyProgrammingLab" 


15.13 What is a recursive helper function? 

15.14 Show the call stack for sort ([2, 3, 5, 1]) using the function defined in 

Listing 15.5. 


r^Key 
C' / Point 


15.6 Case Study: Finding the Directory Size 

Recursive functions can efficiently solve problems with recursive structures. 

The preceding examples can easily be solved without using recursion. This section presents a 
problem that is difficult to solve without using recursion. The problem is to find the size of a 
directory. The size of a directory is the sum of the sizes of all the files in the directory. A direc¬ 
tory d may contain subdirectories. Suppose a directory contains files/i,/ 2 , ... and subdi¬ 
rectories di, d 2 , ■■■ , d,„ as shown in Figure 15.5. 



The size of the directory can be defined recursively as follows: 
size{d) = sizeifi) + sizeiff) + . . . + size{f„) + size{di) + sizeidf) + . . . + size{dn) 
To implement the program, you need the following three functions from the os module: 

■ os.path. isfile(s), which returns True if s is a filename. Recall that this func¬ 
tion was introduced in §13.2.3 to check if a file exists. 

■ os. path, getsize (filename), which returns the size of the file. 

■ os.l istdirCdirectory), which returns a list of the subdirectories and files 
under the directory. 

The program in Listing 15.7 prompts the user to enter a directory or a filename and dis¬ 
plays its size. 
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Listing 15.7 Di rectorySize.py 

1 import os 

2 

3 def mainO : 

4 # Prompt the user to enter a directory or a file 

5 path = inputC'Enter a directory or a file: ")-strip() 

6 

7 # Display the size 

8 try: 

9 print(getSize(path), "bytes") 

10 except : 

11 pri ntC'Directory or file does not exist") 

12 

13 def getSize(path) : 

14 size = 0 # Store the total size of all files 

15 

16 if not os.path.isfi1e(path) : 

17 1st = os.listdir(path) # All files and subdirectories 

18 for subdirectory in 1st: 

19 size += getSizeCpath + "\\" + subdirectory) 

20 else: # Base case, it is a file 

21 size += os.path.getsize(path) # Accumulate file size 

22 

23 return size 

24 

2 5 mainO # Call the main function 


Enter a directory or a file: c:\pybook | 
619631 bytes 


Enter a directory or a file: c:\pybook\Welcome.py pEnter 
76 bytes 


Enter a directory or a file: c:\book\NonExistentFile 
Directory or file does not exist 


If the path is a directory (line 16), each suhitem (file or subdirectory) in the directory is 
recursively invoked to obtain its size (line 19). If the path is a file (line 20), the file size is 
obtained (line 21). 

If the user enters an incorrect or a nonexistent file or directory, the program throws an 
exception (line 11). 

Tip 

To avoid mistakes, it is a good practice to test base cases. For example, you should test 
the program for an input of a filename, an empty directory, a nonexistent directory, and 
a nonexistent filename. 

15.15 What function do you use to test if a filename exists? What function do you use to 
return the size of a file? What function do you use to return all files and subdirectories 
under a directory? 



invoke function 

getSi ze function 

is directory? 
all subitems 

recursive call 

base case 



testing base cases 

/Check 
V Point 

MyProgrammingLab" 
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15.7 Case Study: Towers of Hanoi 

The Towers of Hanoi problem is a classic problem that can be solved easily by using 
recursion, but it is dijficult to solve otherwise. 


The Towers of Hanoi problem is a classic recursion problem that every computer scientist 
knows. The problem involves moving a specified number of disks of distinct sizes from one 
tower to another while observing the following rules: 


■ There are n disks labeled 1, 2, 3, . . n, and three towers labeled A, B, and C. 

■ No disk can be on top of a smaller disk at any time. 

■ All the disks are initially placed on tower A. 

■ Only one disk can be moved at a time, and it must be the top disk on a tower. 

The objective of the problem is to move all the disks from tower A to tower B with the 
assistance of tower C. For example, if you have three disks, the steps to move all of the disks 
from tower A to B are shown in Figure 15.6. 


ku/— - 
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B C 




Original position 
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B C 



Step 1: Move disk f from A to B 
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Step 2; Move disk 2 from A to C 














iC- 

3 

- h 

J 


A 

B C 



Step 3: Move disk 1 from B to C 


0 

I ' 

I A B C 

i Step 4: Move disk 3 from A to B 

(5) „„„„„„„„„„„„„„„„ 

I A B C 

i Step 5: Move disk 1 from C to A 





I A B C 

I Step 6: Move disk 2 from C to B 



ABC 
Step 7: Move disk 1 from A to B 


Figure 15.6 The goal of the Towers of Hanoi problem is to move disks from tower A to 
tower B without breaking the rules. 



Note 

The Towers of Hanoi is a ciassic computer-science problem, to which many Web sites 
are devoted. One of them worth looking at is www.cut-the-knot.com/recurrence/hanoi.shtml. 
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In the case of three disks, you can find the solution manually. For a larger number of disks, 
however—even for four—the problem is quite complex. Fortunately, the problem has an 
inherently recursive nature, which leads to a straightforward recursive solution. 

The base case for the problem is n = 1. If n == 1, you could simply move the disk from 
A to B. When n > 1, you could split the original problem into three subproblems and solve 
them sequentially, as follows; 

1. Move the first n - 1 disks from A to C with the assistance of tower B, as shown in Step 1 
in Figure 15.7. 

2. Move disk n from A to B, as shown in Step 2 in Figure 15.7. 

3. Move n - 1 disks from C to B with the assistance of tower A, as shown in Step 3 in 
Figure 15.7. 


r n-l disksl 


<g)(2)- 


A B C 

Original position 


Q- 


3 


Step 1: Move the first n-l disks from 
A to C recursively 



A B 

Step 2: Move disk n from A to B 


1 n-l disks i j 

Ie^ il 

j n-l disks | 

1 1 

iei=3j| 



Step 3: Move n-l disks from 
C to B recursively 


Figure 15.7 The Towers of Hanoi problem can be decomposed into three subproblems. 


The following function moves n disks from the f romTower to the toTower with the assis¬ 
tance of the auxTower: 

def moveDisks(n, fromTower, toTower, auxTower): 


The algorithm for the function can be described as follows: 

if n == 1: # Stopping condition 

Move disk 1 from the fromTower to the toTower 

else: 

moveDisksfn - 1, fromTower, auxTower, toTower) 
Move disk n from the fromTower to the toTower 
moveDisksfn - 1, auxTower, toTower, fromTower) 


The program in Listing 15.8 prompts the user to enter the number of disks and invokes the 
recursive function moveDisks to display the solution for moving the disks. 


Listing 15.8 TowersOfHanoi. py 

1 def mai n () : 

2 n = eval(i nputC'Enter number of disks: ")) 

3 
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4 # Find the solution recursively 

5 printC'The moves are;") 

6 moveDisks(n, 'A', 'E', 'C') 

7 

8 # The function for finding the solution to move n disks 

9 # from fromTower to toTower with auxTower 

10 def moveDisks(n, fromTower, toTower, auxTower): 


base case 

11 

if n == 1: # Stopping condition 




12 

pri ntC'Move 

disk", n, "from" 

, fromTower, "to". 

toTower) 


13 

el se : 




recursion 

14 

moveDisks(n 

- 1, fromTower, 

auxTower, toTower) 



15 

pri ntC'Move 

disk", n, "from" 

, fromTower, "to". 

toTower) 

recursion 

16 

moveDisks(n 

- 1, auxTower, toTower, fromTower) 



17 

18 main() # Call the main function 


Enter number of disks: 
The moves are: 

; 4 

Move 

di sk 

1 

from 

A 

to 

c 

Move 

di sk 

2 

from 

A 

to 

B 

Move 

di sk 

1 

from 

C 

to 

B 

Move 

di sk 

3 

from 

A 

to 

c 

Move 

di sk 

1 

from 

B 

to 

A 

Move 

di sk 

2 

from 

B 

to 

c 

Move 

di sk 

1 

from 

A 

to 

c 

Move 

di sk 

4 

from 

A 

to 

B 

Move 

di sk 

1 

from 

C 

to 

B 

Move 

di sk 

2 

from 

C 

to 

A 

Move 

di sk 

1 

from 

B 

to 

A 

Move 

disk 

3 

from 

C 

to 

B 

Move 

disk 
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from 
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to 

c 

Move 

disk 
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from 

A 

to 

B 

Move 

di sk 

1 

from 

C 

to 

B 


Consider tracing the program for n = 3. The successive recursive calls are shown in 
Figure 15.8. As you can see, writing the program is easier than tracing the recursive calls. The 
system uses stacks to trace the calls behind the scenes. To some extent, recursion provides a 
level of abstraction that hides iterations and other details from the user. 



moveDisksO, 'A' , 'B' , 'C') 


moveDisks(2, 'A' , 'C , 'B') 
move disk 3 from A to B 
moveDisks(2, 'C , 'B' , 'A') 


moveDisks(2,'A','C','B') 


moveDisksfl,'A','B','C') 
move disk 2 from A to C 
moveDisks(l, 'B' , 'C , 'A') 


moveDisks(2,'C','B','A') 


moveDisks(l,'C','A','B') 
move disk 2 from C to B 
moveDisks(l,'A','B','C') 


moveDisksCl,'A' , 'B' 

■C) 


moveDisksCl, 'B' , 'C , 'A') 


moveDisksCl,'C','A','B') 


moveDisksCl,'A','B','C') 

move disk 1 from A 

to B 


move disk 1 from B to C 


move disk 1 from C to A 


move disk 1 from A to B 


Figure 15.8 Invoking moveDi sks (3, 'A', 'B', 'C') spawns calls to moveDi sks recursively. 
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15.16 How many times would the moveDisks function in Listing 15.8 be invoked for 

moveDisksCS, 'A', 'B', 'C')? 


/Check 

\ Point 


15.8 Case Study: Fractals 

Recursion is ideal for displaying fractals, because fractals are inherently recursive. 

A fractal is a geometrical figure, but unlike triangles, circles, and rectangles, fractals can be 
divided into parts, each of which is a reduced-size copy of the whole. There are many inter¬ 
esting examples of fractals. This section introduces a simple fractal, the Sierpinski triangle, 
named after a famous Polish mathematician. 

A Sierpinski triangle is created as follows: 


MyProgrammingLab' 

r Point 


1. Begin with an equilateral triangle, which is considered to be a Sierpinski fractal of 
order (or level) 0, as shown in Figure 15.9a. 

2. Connect the midpoints of the sides of the triangle of order 0 to create a Sierpinski trian¬ 
gle of order 1 (Figure 15.9b). 

3. Leave the center triangle intact. Connect the midpoints of the sides of the three other tri¬ 
angles to create a Sierpinski triangle of order 2 (Figure 15.9c). 

4. You can repeat the same process recursively to create a Sierpinski triangle of order 3, 4, 
and so on (Figure 15.9d). 



(a) Order 0 


(b) Order 1 



(c) Order 2 

Figure 15.9 A Sierpinski triangle is a pattern of recursive triangles. 


(d) Order 3 
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create a canvas 


create an entry 
create a button 


display triangle 


recursive triangles 


draw one triangle 


get midpoints 


The problem is inherently recursive. How do you develop a recursive solution for it? Con¬ 
sider the base case when the order is 0. It is easy to draw a Sierpinski triangle of order 0. How 
do you draw a Sierpinski triangle of order 1? The problem can be reduced to drawing three Sier¬ 
pinski triangles of order 0. How do you draw a Sierpinski triangle of order 2? The problem can 
be reduced to drawing three Sierpinski triangles of order 1, so the problem of drawing a Sier¬ 
pinski triangle of order n can be reduced to drawing three Sierpinski triangles of order n - 1. 

Listing 15.9 is a program that displays a Sierpinski triangle of any order, as shown in Figure 
15.9. You can enter an order in a text field to display a Sierpinski triangle of the specified order. 


Listing 15.9 SierpinskiTriangle.py 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 


from tkinter import * # Import all definition from tkinter 

class SierpinskiTriangle: 

def _i ni t_(sel f) : 

window = Tk() # Create a window 

window.titl eC'Sierpinski Triangle') # Set a title 

self.width = 200 

self.height = 200 

self.canvas = Canvas(window, 

width = self.width, height = self.height) 
self.canvas.pack() 

# Add a label, an entry, and a button to framel 

framel = Frame(window) # Create and add a frame to window 

framel. packO 

Label(framel, 

text = "Enter an order: ").pack(side = LEFT) 
self.order = StringVarO 

entry = Entry(framel, textvariable = self.order , 
justify = RIGHT).pack(side = LEFT) 

Button(framel, text = "Display Sierpinski Triangle", 
command = self.display).pack(side = LEFT) 

window.mainloopO # Create an event loop 

def display(self): 

self.canvas.del ete("l ine") 

pi = [self.width / 2, 10] 

p2 = [10, self.height - 10] 

p3 = [self.width - 10, self.height - 10] 

self .displayTriangles(int(self .order.getO) , pi, p2 , p3) 

def displayTriangles(self, order, pi, p2, p3): 
if order == 0: # Base condition 

# Draw a triangle to connect three points 
self.drawLine(pl, p2) 

self.drawLine(p2, p3) 
self.drawLine(p3, pi) 
el se : 

# Get the midpoint of each triangle's edge 
pl2 = self.midpoint(pl, p2) 

p23 = self.midpoint(p2, p3) 
p31 = self.midpoint(p3, pi) 

# Recursively display three triangles 

self.displayTriangles(order - 1, pi, pl2, p31) 


top subtriangle 
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49 

self.displayT riangles(order 

- 1. 

pl2, p2, p23) 

left subtriangle 

50 

self.displayT riangles(order 

- 1. 

p31, p23, p3) 

right subtriangle 

51 





52 

def drawLine(self, pi, p2): 



draw a line 

53 

self.canvas.create_line( 




54 

pl[0], pl[l], p2[i)], p2[l], 

tags 

= "line') 


55 





56 

# Return the midpoint between two points 



57 

def midpoint(self, pi, p2): 



midpoint 

58 

p = 2 " [0] 




59 

p[0] = (pl[ ] + p2[ ]) / 2 




60 

p[l] = (pl[l] + p2[l]) / 2 




61 

return p 




62 





63 

SierpinskiTriangleO # Create GUI 



create GUI 


When you enter an order in the text field and then click the Display Sierpinski Triangle 
button, the callback display function is invoked to create three points and display the trian¬ 
gle (lines 30-33). 

The three points of the triangle are passed to invoke displayTriangles (line 35). If 
order == 0, the displayTri angles (order, pi, p2, p3) function displays a triangle 
that connects three points pi, p2, and P3 in lines 38^0, as shown in Figure 15.10a. Other¬ 
wise, it performs the following tasks: 

1. Obtains a midpoint between pi and p2 (line 43), a midpoint between p2 and p3 (line 
44), and a midpoint between p3 and pi (line 45), as shown in Figure 15.10b. 

2. Recursively invokes di spl ayTri angl es with a reduced order to display three smaller 
Sierpinski triangles (lines 48-50). Note that each small Sierpinski triangle is struc¬ 
turally identical to the original big Sierpinski triangle except that the order of a small 
triangle is one less, as shown in Figure 15.10b. 


display function 

di spi ayT riangies 
function 


pi Draw the Sierpinski triangle 



Recursively draw the small 
Sierpinski triangle 
displayT riangles ( 
order - 1, pl2, p2, 



(b) 


Figure 15.10 Drawing a Sierpinski triangle spawns calls to draw three small Sierpinski triangles recursively. 
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15.9 Case Study: Eight Queens 

The Eight Queens problem is to find a solution to place a queen in each row on a 
chessboard so that no two queens can attack each other. 


This case study creates a program that arranges eight queens on a chessboard. There can only 
be one queen in each row, and the queens must be positioned such that no two queens can take 
the other. You need to use a two-dimensional list to represent the chessboard, but because 
each row can have only one queen, it is sufficient to use a one-dimensional list to denote the 
queen’s position in the row. So, create a list named queens as follows: 


queens = 8 * [- 1 ] 


Assign j to queens [i] to denote that a queen is placed in row i and column j. Figure 
15.11a shows the contents of the list queens for the chessboard in Figure 15.11b. Initially, 
queens [i] = -1 indicates that row i is not occupied. 


queens[01 

0 



queens[l] 

4 



queensp] 

7 



queenspl 

5 



queens[41 

2 



queens[51 

6 



queens[61 

1 



queens[71 

3 




(a) (b) 


Figure 15.11 queens [i] denotes the position of the queen in row 


The program in Listing 15.10 displays a solution for the Eight Queens problem. 


initialize queens 
start search 


create queen image 
display chessboard 


Listing 15.10 EightQueens.py 

1 from tkinter import * # Import all definitions from tkinter 

2 

3 SIZE = 8 # The size of the chessboard 

4 class EightQueens; 

5 def _init_(self): 

6 self.queens = SIZE * [-1] # Queen positions 

7 self .search(O) # Search for a solution from row 0 

8 

9 # Display solution in queens 

10 window = Tk() # Create a window 

11 window. titleC'Eight Queens") # Set a title 

12 

13 image = Photolmageffi 1 e = "image/queen.gif ) 

14 for i in range(SIZE): 

15 for j in range(SIZE): 

16 if self.queens[i] == j: 

17 Label(window, image = image).grid( 

18 row = i, column = j) 


display queen 
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19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 


else: 

Label(window, width = 5, height = 2, 

bg = "red") .gtidCrow = i, column = j) 

window.mainloopO # Create an event loop 

# Search for a solution starting from a specified row 
def search(self, row): 

if row == SIZE: # Stopping condition 

return True # A solution found to place 8 queens 

for column in range(SIZE): 

self.queens[row] = column # Place it at (row, column) 
if self.isValid(row, column) and self.search(row + 1): 
return True # Found and exit for loop 

# No solution for a queen placed at any column of this row 

return False 

# Check if a queen can be placed at row i and column j 
def isValid(self, row, column): 

for i in range (1, row + 1): 

if (self.queens[row - i] == column # Check column 
or self.queens[row - i] == column - i 
or self.queens[row - i] == column + i) : 
return False # There is a conflict 

return True # No conflict 

EightQueensO # Create GUI 


search this row 


search columns 
place a queen 
recursive call 
found 


not found 


check validity 

check column 
check upleft diagonal 
check upright diagonal 


The program initializes the list queens with eight values -1 to indicate that no queens 
have been placed on the chessboard (line 6). The program invokes search (0) (line 7) to start 
a search for a solution from row 0, which recursively invokes search(1), search(2), 
and search(7) (line 32). 

After a solution is found, the program displays 64 labels in the window (8 per row) and 
places a queen image in the cell at queens [1] for each row i (line 17). 

The recursive search (row) function returns True if all the rows are filled (lines 
27-28). The function checks whether a queen can be placed in column 0, 1, 2, ..., and 7 in 
a for loop (line 30). The program places a queen in the column (line 31). If the placement 
is valid, the program recursively searches for the next row by invoking searchfrow + 1) 
(line 32). If this search is successful, the program returns True (line 33) to exit the for 
loop. In this case, there is no need to look for the next column in the row. If there is no solu¬ 
tion that allows a queen to be placed in any column in this row, the function returns Fal se 
(line 36). 

Suppose you invoke search (row) for row 3, as shown in Figure 15.12a. The function 
tries to fill in a queen in column 0, 1, 2, and so on in this order. For each trial, the 
i sVal i d (row, col umn) function (line 32) is called to check whether placing a queen at the 
specified position causes a conflict with the queens placed earlier. It also ensures that no 
queen is placed in the same column (line 41), upper left diagonal (line 42), or upper right 
diagonal (line 43), as shown in Figure 15.12b. If isVal id(row, col umn) returns Fal se, 
the program checks the next column, as shown in Figure 15.12c. If isVal id (row, col umn) 
returns True, the program recursively invokes search (row + 1), as shown in Figure 
15.12d. If search (row + 1) returns Fal se, the program checks the next column on the 
preceding row, as shown Figure 15.12c. 
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Figure 15.12 Invoking search(row) fills in a queen in a column in the row. 




recursion overhead 


recursion advantages 


recursion or iteration? 


15.10 Recursion vs. Iteration 

Recursion is an alternative form of program control. It is essentially repetition without 
Point a loop. 

When you use loops, you specify a loop body. The repetition of the loop body is controlled by 
the loop control structure. In recursion, the function itself is called repeatedly. A selection 
statement must be used to control whether to call the function recursively or not. 

Recursion bears substantial overhead. Each time the program calls a function, the system must 
allocate memory for all of the function’s local variables and parameters. This can consume 
considerable computer memory and requires extra time to manage the additional memory. 

Any problem that can be solved recursively can be solved nonrecursively with iterations. 
Recursion has at least one negative aspect: that is, it uses up too much time and memory. Why, 
then, should you use it? In some cases, using recursion enables you to specify a clear, simple 
solution for an inherently recursive problem that would otherwise be difficult to achieve. For 
example, the directory-size problem, the Towers of Hanoi problem, and the fractal problem 
are rather cumbersome to solve without using recursion. 

The decision whether to use recursion or iteration should be based on the nature of, and your 
understanding of, the problem you are trying to solve. The rule of thumb is to use whichever 
approach can best develop an intuitive solution that naturally mirrors the problem. If an iterative 
solution is obvious, use it—it will generally be more efficient than the recursive option. 


stack overflow 



Caution 

Recursive programs can run out of memory, causing a stack-overflow exception. 


performance concern 


Tip 

Avoid using recursion if you are concerned about your program’s performance, because 
it takes more time and consumes more memory than iteration. In general, recursion can 
be used to solve the inherent recursive problems such as Towers of Hanoi, Directory 
size, and Sierpinski triangles. 
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15.17 Which of the following statements are true? 

■ Any recursive function can he converted into a nonrecursive function. 

■ Recursive functions take more time and memory to execute than nonrecursive 
functions. 


^raeck 
Ir Point 

MyProgrammingLab" 


■ Recursive functions are always simpler than nonrecursive functions. 

■ There is always a selection statement in a recursive function to check whether a 
base case is reached. 

15.18 What is a cause for a stack-overflow exception? 


15.11 Tail Recursion 

A tail recursive function is efficient for reducing stack size. 

A recursive function is said to be tail recursive if there are no pending operations to be per¬ 
formed on return from a recursive call, as illustrated in Figure 15.13a. However, function B in tail recursive 
Figure 15.13b is not tail recursive because there are pending operations after a function call is 
returned. 


tr/Key 
^ y Point 


Recursive function A 


Recursive function B 



Invoke function B recursively 

Invoke function A recursively 



(a) Tail recursion 

(b) Nontail recursion 


Figure 15.13 A tail-recursive function has no pending operations after a recursive call. 


For example, the recursive i sPal i ndromeHe! per function (lines 4—10) in Listing 15.4 is 
tail recursive because there are no pending operations after recursively invoking 
isPal indromeHel per in line 10. However, the recursive factorial function (lines 6-10) 
in Listing 15.1 is not tail recursive, because there is a pending operation, namely multiplica¬ 
tion, to be performed on return from each recursive call. 

Tail recursion may be desirable: Because the function ends when the last recursive call 
ends, there is no need to store the intermediate calls in the stack. 

A nontail-recursive function can often be converted to a tail-recursive function by using 
auxiliary parameters. These parameters are used to contain the result. The idea is to incorpo¬ 
rate the pending operations into the auxiliary parameters in such a way that the recursive call 
no longer has a pending operation. You may define a new auxiliary recursive function with the 
auxiliary parameters. For example, the factorial function in Listing 15.1 can be written in 
a tail-recursive way as follows: 

original function 
invoke auxiliary function 

auxiliary function 


1 # Return the factorial for a specified number 

2 def factorial(n): 

3 return factorialHelper(n, 1) # Call auxiliary function 

4 

5 # Auxiliary tai1-recursive function for factorial 

6 def factorialHelper(n, result): 
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7 if n == 0: 

8 return result 

9 else: 

10 return factorialHelper(n - 1, n * result) 

The first factorial function simply invokes the auxiliary function (line 3). In line 6, the 
auxiliary function contains the auxiliary parameter resul t that stores the result for a factorial 
of n. This function is invoked recursively in line 10. There is no pending operation after a call 
is returned. The final result is returned in line 8, which is also the return value from invoking 

factorial Hel per (n, l)inline3. 

15.19 What is tail recursion? 

15.20 Why is tail recursion desirable? 

15.21 Is the recursive selection function in Listing 15.5 tail recursive? 

15.22 Rewrite the fib function in Listing 15.2 using tail recursion. 

Key Terms 
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direct recursion 503 
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infinite recursion 503 


Chapter Summary 


1. A recursive function is one that directly or indirectly invokes itself. For a recursive 
function to terminate, there must be one or more base cases. 

2 . Recursion is an alternative form of program control. It is essentially repetition with¬ 
out a loop control. It can be used to specify simple, clear solutions for inherently 
recursive problems that would otherwise be difficult to solve. 

3 . Sometimes the original function needs to be modified to receive additional parame¬ 
ters in order to be invoked recursively. A recursive helper function can be defined for 
this purpose. 

4. Recursion bears substantial overhead. Each time the program calls a function, the 
system must allocate memory for all of the function’s local variables and parameters. 
This can consume considerable computer memory and requires extra time to manage 
the additional memory. 

5 . A recursive function is said to be tail recursive if there are no pending operations to 
be performed on return from a recursive call. Tail recursion is efficient. 
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Test Questions 


Do test questions for this chapter online at www.cs.armstrong.edu/liang/py/test.html. 
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Programming Exercises 
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Sections 15.2-15.3 

*15.1 {Sum the digits in an integer using recursion) Write a recursive function that com¬ 
putes the sum of the digits in an integer. Use the following function header: 

def sumDigits(n): 

For example, sumD1gits(234) returns 2 -f 3 + 4 = 9. Write a test program 
that prompts the user to enter an integer and displays its sum. 

*15.2 {Fibonacci numbers) Rewrite the fib function in Listing 15.2 using iterations. 

(Hint: To compute fib(n) without recursion, you need to obtain fib(n - 2) 
and fibCn - 1) first.) Let fO and f 1 denote the two previous Fibonacci num¬ 
bers. The current Fibonacci number would then be fO -r f 1. The algorithm can be 
described as follows: 

fO = 0 # For fibs(O) 
fl = 1 # For fib(l) 

for i in range (2, n + 1) : 
currentFib = fO + fl 
fO = fl 

fl = currentFib 


# After the loop, currentFib is fib(n) 

Write a test program that prompts the user to enter an index and displays its 
Fibonacci number. 


*15.3 {Compute greatest common divisor using recursion) The gcd(m, n) can also be 
defined recursively as follows: 

■ If m % nisO, gcdCm, n) is n. 

■ Otherwise, gcdCm, n)isgcd(n, m % n). 

Write a recursive function to find the GCD. Write a test program that prompts the 
user to enter two integers and displays their GCD. 


15.4 


15.5 


*15.6 


*15.7 


{Sum series) Write a recursive function to compute the following series: 

1 


1 1 

m{i) ~ ^ 2 ^ 


-F 


Write a test program that displays m(i) for i = 1, 2, ..., 10. 

{Sum series) Write a recursive function to compute the following series: 

1 2 3 4 5 6 i 

m{i) — — -F — -F — -F — -F — -F — -F . . . -F - 

3 5 7 9 11 13 2( + 1 


Write a test program that displays m(i) for i = 1, 2, ..., 10. 

{Summing series) Write a recursive function to compute the following series: 

1 2 i 

m{i) = -1-F . . . H- 

2 3 i + 1 


Write a test program that prompts the user to enter an integer for i and displays mCi ) . 

{Fibonacci series) Modify Listing 15.2 so that the program finds the number of 
times the fib function is called. (Hint: Use a global variable and increment it 
every time the function is called.) 
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Section 

*15.8 


*15.9 


*15.10 


Section 
**I5.I I 


*15.12 

*15.13 


*15.14 


*15.15 


15.4 

{Print the digits in an integer reversely) Write a recursive function that displays 
an integer value reversely on the console using the following header; 

def reverseDisplay(value): 

For example, invoking reverseDi splay(12345) displays 54321. Write a test 
program that prompts the user to enter an integer and displays its reversal. 

{Print the characters in a string reversely) Write a recursive function that dis¬ 
plays a string reversely on the console using the following header: 

def reverseDisplay(value): 

For example, reverseDi splay ("abed") displays deba. Write a test program 
that prompts the user to enter a string and displays its reversal. 

{Occurrences of a specified character in a string) Write a recursive function that 
finds the number of occurrences of a specified letter in a string using the follow¬ 
ing function header. 

def countfs, a): 

For example, count ("Wei come" , 'e') returns 2. Write a test program that 

prompts the user to enter a string and a character, and displays the number of 
occurrences for the character in the string. 

15.5 

{Print the characters in a string reversely) Rewrite Exercise 15.9 using a helper 
function to pass the substring for the high index to the function. The helper 
function header is: 

def reverseDisplayHelper(s, high): 

{Find the largest number in a list) Write a recursive function that returns the 
largest integer in a list. Write a test program that prompts the user to enter a list 
of integers and displays the largest element. 

{Find the number of uppercase letters in a string) Write a recursive function to 
return the number of uppercase letters in a string using the following function 
headers: 

def countUppercase(s) : 

def countUppercaseHelper(s, high): 

Write a test program that prompts the user to enter a string and displays the num¬ 
ber of uppercase letters in the string. 

{Occurrences of a specified character in a string) Rewrite Exercise 15.10 using a 
helper function to pass the substring of the high index to the function. The 
helper function header is: 

def countHelper(s, a, high): 

{Find the number of uppercase letters in a list) Write a recursive function to 
return the number of uppercase letters in a list of characters. You need to define 
the following two functions. The second one is a recursive helper function. 

def count(chars): 

def countHelperfehars, high): 

Write a test program that prompts the user to enter a list of characters in one line 
and displays the number of uppercase letters in the list. 
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*15.16 

(Occurrences of a specified character in a list) Write a recursive function that finds 
the number of occurrences of a specified character in a list. You need to define the 
following two functions. The second one is a recursive helper function. 

def count(chars, ch): 

def countHelper(chars, ch, high): 

Write a test program that prompts the user to enter a list of characters in one line, 
and a character, and displays the number of occurrences of the character in the list. 


Sections 15.6-15.11 

*15.17 {Tkinter: Sierpinski triangle) Revise Listing 15.9 to let the user use left- 


*15.18 

mouse/right-mouse clicks to increase/decrease the current order by 1. The initial 
order is 0. 

(Towers of Hanoi) Modify Listing 15.8, TowersOfHanoi.py, so that the program 
finds the number of moves needed to move n disks from tower A to tower B. 

(Hint: Use a global variable and increment it for every move.) 

*15.19 

(Decimal to binary) Write a recursive function that converts a decimal number 
into a binary number as a string. The function header is as follows: 

def decimalToBinaryCvalue): 

*15.20 

Write a test program that prompts the user to enter a decimal number and dis¬ 
plays its binary equivalent. 

(Decimal to hex) Write a recursive function that converts a decimal number into 
a hex number as a string. The function header is as follows: 

def decimalToHex(value): 

*15.21 

Write a test program that prompts the user to enter a decimal number and dis¬ 
plays its hex equivalent. 

(Binary to decimal) Write a recursive function that parses a binary number as a 
string into a decimal integer. The function header is as follows: 

def hi naryToDeci trial (hi naryStri ng) : 

*15.22 

Write a test program that prompts the user to enter a binary string and displays its 
decimal equivalent. 

(Hex to decimal) Write a recursive function that parses a hex number as a string 
into a decimal integer. The function header is as follows: 

def hexToDecimal(hexString): 

**15.23 

Write a test program that prompts the user to enter a hex string and displays its 
decimal equivalent. 

(String permutation) Write a recursive function to print all the permutations of a 
string. For example, for the string abc, the printout is: 

abc 

acb 

bac 

bca 

cab 

cba 

(Hint: Define the following two functions. The second function is a helper function. 

def displayPermuation(s): 

def displayPermuationHelper(sl, s2): 
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The first function simply invokes displayPermuationC" ", s). The second 
function uses a loop to move a character from s2 to si and recursively invokes 
it with a new si and s2. The base case is that s2 is empty and prints si to the 
console.) 

Write a test program that prompts the user to enter a string and displays all its 
permutations. 

* 1 5.24 {Number of files in a directory) Write a program that prompts the user to enter a 
directory and displays the number of files in the directory. 

** 15.25 {Tkinter: Koch snowflake fractal) Section 15.8 presented the Sierpinski triangle 
fractal. In this exercise, you will write a program to display another fractal, 
called the Koch snowflake, named after a famous Swedish mathematician. A 
Koch snowflake is created as follows: 

1. Begin with an equilateral triangle, which is considered to be the Koch fractal 
of order (or level) 0, as shown in Figure 15.14a. 

2. Divide each line in the shape into three equal line segments and draw an out¬ 
ward equilateral triangle with the middle line segment as the base to create a 
Koch fractal of order 1, as shown in Figure 15.14b. 

3. Repeat Step 2 to create a Koch fractal of order 2, 3, ..., and so on, as shown in 
Figure 15.14c-d. 



Figure 15.14 A Koch snowflake is a fractal starting with a triangle. 


** 15.26 {Turtle: Koch snowflake fractal) Rewrite the Koch snowflake program in Exer¬ 
cise 15.25 using Turtle, as shown in Figure 15.15. Your program should prompt 
the user to enter the order and display the corresponding fractal for the order. 






Figure 15.15 The Koch snowflake fractal is drawn using Turtle. 
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**15.27 

**15.28 

**15.29 


**15.30 


{All eight queens) Modify Listing 15.10, EightQueens.py, to find all the possible 
solutions to the Eight Queens problem. 

{Find words) Write a program that finds all the occurrences of a word in all the 
files under a directory, recursively. Your program should prompt the user to enter 
a directory name. 

{Tkinter: H-tree fractal) An H-tree is a fractal defined as follows: 

1. Begin with a letter H. The three lines of the H are of the same length, as shown 
in Eigure 15.1a. 

2. The letter H (in its sans-serif form, H) has four endpoints. Draw an H centered 
at each of the four endpoints to an H-tree of order 1, as shown in Eigure 15.1b. 
These Hs are half the size of the H that contains the four endpoints. 

3. Repeat Step 2 to create an H-tree of order 2, 3, ..., and so on, as shown in 
Eigure 15.1c-d. 

Write a Python program that draws an H-tree, as shown in Eigure 15.1. 

{Turtle: H-tree fractal) Rewrite the H-tree fractal in Exercise 15.29 using Turtle, 
as shown in Eigure 15.16. Your program should prompt the user to enter the 
order and display the corresponding fractal for the order. 
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(d) 


Figure 15.16 An H-tree fractal is drawn using Turtle for order of 0 in (a), 1 in (b), 2 in (c), and 3 in (d). 


**15.31 {Tkinter: Recursive tree) Write a program to display a recursive tree, as shown in 
Eigure 15.17. 



Figure 15.17 A recursive tree with the specified depth is drawn. 


**15.32 {Turtle: Recursive tree) Rewrite the recursive tree in Exercise 15.31 using Turtle, 
as shown in Eigure 15.18. Your program should prompt the user to enter the 
order and display the corresponding fractal for the order. 
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(a) 



(b) 




Figure 15.18 


A recursive tree is drawn using Turtle with depth 0 in (a), 1 in (b), 2 in (c), and 3 in (d). 


**15.33 (Tkinter: Hilbert curve) The Hilbert curve, first described by German mathe¬ 
matician David Hilbert in 1891, is a space-filling curve that visits every point in 
a square grid with a size of 2 X 2, 4 X 4, 8 X 8, 16 X 16, or any other power 
of 2. Write a program that displays a Hilbert curve for the specified order, as 
shown in Figure 15.19. 






Figure 15.19 A Hilbert curve with the specified order is drawn. 


**15.34 {Turtle: Hilbert curve) Rewrite the Hilbert curve in Exercise 15.33 using Turtle, 
as shown in Figure 15.20. Your prsogram should prompt the user to enter the 
order and display the corresponding fractal for the order. 





Figure 15.20 A Hilbert curve is drawn using Turtle with order 0 in (a), 1 in (b), 2 in (c), and 3 in (d). 
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15.35 (Tkinter: Sierpinski triangle) Revise Listing 15.9, SierpinskiTriangle.py, to dis¬ 
play the filled Sierpinski triangles, as shown in Figure 15.21. 


Sierpinski Trianale 


7-^ Sierpinski 

A 

▲▲ 


A 

AA 

^ ^ 1 
AAAA 

A A 

AA AA 
AAAA 
AAAAAAAA 

Enter an order 1 1 Display SierpinskiTriangle 1 


Enter an order 3| Display SierpinskiTriangle 


Figure 15.21 Filled Sierpinski triangles are displayed. 


15.36 {Turtle: Sierpinski triangle) Rewrite Listing 15.9, SierpinskiTriangle.py, using 
Turtle. 
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Appendix A 


Python Keywords 

The following keywords are reserved by the Python language. They should not be used for 
anything other than their predefined purpose in Python. 


and 

el se 

in 

return 

as 

except 

is 

True 

assert 

Fal se 

lambda 

try 

break 

finally 

None 

while 

class 

for 

nonlocal 

with 

continue 

from 

not 

yield 

def 

gl obal 

or 


del 

if 

pass 


el if 

import 

raise 
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The ASCII Character Set 

Tables B.l and B.2 show ASCII characters and their respective decimal and hexadecimal 
codes. The decimal or hexadecimal code of a character is a combination of its row index and 
column index. For example, in Table B.l, the letter A is at row 6 and column 5, so its decimal 
equivalent is 65; in Table B.2, letter A is at row 4 and column 1, so its hexadecimal equiva¬ 
lent is 41. 
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Table B.l ASCII Character Set in the Decimal Index 



0 

1 


2 

3 


4 

5 


6 

7 


8 


9 


0 

nul 

soh 


stx 

etx 


eot 

enq 


ack 

bel 


bs 


ht 


1 

nl 

vt 


ff 

cr 


SO 

si 


die 

del 


dc2 


dc3 


2 

dc4 

nak 


syn 

etb 


can 

em 


sub 

esc 


fs 


gs 


3 

rs 

US 


sp 

! 


” 

# 


$ 

% 


& 




4 

( 

) 


* 

+ 



- 



/ 


0 


1 


5 

2 

3 


4 

5 


6 

7 


8 

9 




; 


6 

< 

= 


> 

7 


@ 

A 


B 

C 


D 


E 


7 

F 

G 


H 

I 


J 

K 


L 

M 


N 


0 


8 

P 

Q 


R 

s 


T 

U 


V 

W 


X 


Y 


9 

Z 

[ 


\ 

] 


A 

- 


‘ 

a 


b 


c 


10 

d 

e 


f 

g 


h 

i 


j 

k 


1 


m 


11 

n 

o 


P 

q 


r 

s 


t 

u 


V 


w 


12 

X 

y 


z 

{ 


1 

} 


~ 

del 






Table B.2 ASCII Character Set in the Hexadecimal Index 


0 I 

2 

3 

4 

j 

6 

7 

8 

9 

A 

B 

C 

D 

E 


F 

0 

nul soh 

stx 

etx 

eot 

enq 

ack 

bel 

bs 

ht 

nl 

vt 

ff 

cr 

SO 


si 

1 

die del 

dc2 

dc3 

dc4 

nak 

syn 

etb 

can 

em 

sub 

esc 

fs 

gs 

rs 


us 

2 

sp ! 

” 

# 

$ 

% 

& 


( 

) 

* 

+ 


- 



/ 

3 

0 1 

2 

3 

4 

5 

6 

7 

8 

9 
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> 


7 

4 

@ A 

B 

C 

D 

E 

F 

G 

H 

I 

J 

K 

L 

M 

N 


0 

5 

P Q 

R 

s 

T 

U 

V 

W 

X 

Y 

Z 

[ 

\ 

] 

A 


- 

6 

‘ a 

b 

C 

d 

e 

f 

g 

h 

i 

j 

k 

1 

m 

n 


O 

7 

p q 

r 

S 

t 

u 

V 

W 

X 

y 

Z 

{ 

1 

1 

~ 


del 
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binary numbers 


decimal numbers 


hexadecimal number 


base 

radix 


Number Systems 


C.l Introduction 

Computers use binary numbers internally, because computers are made naturally to store and 
process Os and Is. The binary number system has two digits, 0 and 1. A number or character 
is stored as a sequence of Os and Is. Each 0 or 1 is called a bit (binary digit). 

In our daily life we use decimal numbers. When we write a number such as 20 in a pro¬ 
gram, it is assumed to be a decimal number. Internally, computer software is used to convert 
decimal numbers into binary numbers, and vice versa. 

We write computer programs using decimal numbers. However, to deal with an operating 
system, we need to reach down to the “machine level” by using binary numbers. Binary num¬ 
bers tend to be very long and cumbersome. Often hexadecimal numbers are used to abbrevi¬ 
ate them, with each hexadecimal digit representing four binary digits. The hexadecimal 
number system has 16 digits: 0-9 and A-F. The letters A, B, C, D, E, and F correspond to the 
decimal numbers 10, 11, 12, 13, 14, and 15. 

The digits in the decimal number system are 0, 1,2, 3, 4, 5, 6, 7, 8, and 9. A decimal num¬ 
ber is represented by a sequence of one or more of these digits. The value that each digit rep¬ 
resents depends on its position, which denotes an integral power of 10. For example, the digits 
7, 4, 2, and 3 in decimal number 7423 represent 7000, 400, 20, and 3, respectively, as shown 
below: 


= 7 X 10^ + 4 X 10^ -t- 2 X 10^ -f 3 X 10° 


10^ 10^ 10* 10° = 7000 -f 400 -f 20 -f 3 = 7423 


The decimal number system has ten digits, and the position values are integral powers of 10. 
We say that 10 is the base or radix of the decimal number system. Similarly, since the binary 
number system has two digits, its base is 2, and since the hex number system has 16 digits, its 
base is 16. 

If 1101 is a binary number, the digits 1, 1, 0, and 1 represent 1 X 2^, 1 X 2^, 0 X 2', and 
1 X 2°, respectively: 


1 

1 

0 

1 

2 ^ 

2 ^ 

2 * 

2 ° 


= 1 X 2^ -b 1 X 2^ -(- 0 X 2' -f 1 X 2° 
= 8-b4-b0-bl = 13 


If 7423 is a hex number, the digits 7, 4, 2, and 3 represent 7 X 16^, 4 X 16^, 2 X I6\ and 
3 X 16°, respectively: 


= 7 X 16^ -f 4 X 16^ -b 2 X 16^ -b 3 X 16° 


16^ 16^ 16* 16° = 28672 -b 1024 -b 32 -b 3 = 29731 
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C.2 Conversions Between Binary and Decimal Numbers 

Given a binary number b„b„^ib „^2 ■ ■ ■ the equivalent decimal value is 

b„ X 2" + X 2"^' + fo„_2 X 2"^^ + ... + /72 X 2^ + /7i X 2* + /7o X 2° 
Here are some examples of converting binary numbers to decimals: 


Binary 

Conversion Formula 

Decimal 

10 

1 X 2^ + 0 X 2° 

2 

1000 

1 X 2^ + 0 X 2^ + 0 X 2' + 0 X 2° 

8 

10101011 

1X2'^ + 0X2®+1X2^ + 0X2'‘+1X2^ + 0X22 + 

1 X 2* + 1 X 2° 

171 


To convert a decimal number d to a binary number is to find the bits b„, b„-i, b„^ 2 ^ .. b 2 , bi, 

and bo such that 

d = b„X 2" + b„-i X 2"^' + b„^2 X 2"^^ + . . . + ^2 X 2^ + foi X 2' + X 2° 

These bits can be found by successively dividing by 2 until the quotient is 0. The remainders 
are bo, b^, b 2 ,.. ., 6 „- 2 > K-h and /?„. 

For example, the decimal number 123 is 1111011 in binary. The conversion is done as follows: 




Tip 

The Windows Calculator, as shown in Figure C.l, is a useful tool for performing number 
conversions. To run it, search for Calculator from the Start button and launch Calculator, 
then under View select Scientific. 



Decimal 


Binary 


Hex 


binary to decimal 


decimal to binary 


Figure C.l You can perform number conversions using the Windows Calculator. 
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hex to decimal 


decimal to hex 


hex to binary 


binary to hex 


C.3 Conversions Between Hexadecimal and Decimal 
Numbers 

Given a hexadecimal number h„h„^ih „^2 ■ ■ ■ the equivalent decimal value is 

h„ X 16" + X 16"^^ + /t„_2 X 16"^^ + ... + /t2 X 16^ + /ti X 16* + /to X 16° 
Here are some examples of converting hexadecimal numbers to decimals: 


Hexadecimal 

Conversion Formula 


Decimal 

7F 

7 X 16' + 15 X 16° 


127 

FFFF 

15 X 16° -h 15 X 16° 

+ 15 X 16' -f 15 X 16° 

65535 

431 

4 X 16° + 3 X 16' + 

O 

X 

1073 


To convert a decimal number dto a hexadecimal number is to find the hexadecimal digits 
h„, /t„- 2 , ■ ■ ■, h 2 , hi, and Hq such that 


d = h„X 16" + /!„_i X 16"^' + /t„_2 X 16"^2 + ... + /!2 X 16^ 

+ hiX 16^ + /to X 16° 

These numbers can be found by successively dividing <i by 16 until the quotient is 0. The 
remainders are Hq, hi, /t 2 ,.. ., /t„- 2 , /*«-!, and h„. 

For example, the decimal number 123 is 7B in hexadecimal. The conversion is done as 
follows: 



Quotient 


Remainder 


C.4 Conversions Between Binary and Hexadecimal 
Numbers 

To convert a hexadecimal to a binary number, simply convert each digit in the hexadecimal 
number into a four-digit binary number, using Table C.l. 

For example, the hexadecimal number 7B is 1111011, where 7 is 111 in binary, and B is 
1011 in binary. 

To convert a binary number to a hexadecimal, convert every four binary digits from right to 
left in the binary number into a hexadecimal number. 

For example, the binary number 1110001101 is 38D, since 1101 is D, 1000 is 8, and 11 is 
3, as shown below. 
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Table C.l Converting Hexadecimal to Binary 


Hexadecimal 

Binary 

Decimal 

0 

0000 

0 

1 

0001 

1 

2 

0010 

2 

3 

0011 

3 

4 

0100 

4 

5 

0101 

5 

6 

0110 

6 

7 

0111 

7 

8 

1000 

8 

9 

1001 

9 

A 

1010 

10 

B 

1011 

11 

C 

1100 

12 

D 

1101 

13 

E 

1110 

14 

F 

1111 

15 


Note 

Octal numbers are also useful. The octal number system has eight digits, 0 to 7. A deci¬ 
mal numbers is represented in the octal system as 10. 

Here are some good online resources for practicing number conversions: 

■ http://forums.cisco.eom/CertCom/game/binary_game_page.htm 

■ http://people.sinclair.edu/nickreeder/Flash/binDec.htm 

■ http://people.sinclair.edu/nickreeder/Flash/binHex.htm 

Review Questions 

1. Convert the following decimal numbers into hexadecimal and binary numbers: 

100; 4340; 2000 

2 . Convert the following binary numbers into hexadecimal and decimal numbers: 

1000011001; 100000000; 100111 

3 . Convert the following hexadecimal numbers into binary and decimal numbers: 



FEFA9; 93; 2000 
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Symbols and numbers 
(double quotes), 67-68 
(single quotes), 68 
(subtraction) operator, 40, 43^4 
(quotation marks), 16 
/ (float division) operator, 40^1, 44 
// (integer division) operator, 40-41, 43-44 
\' character, 70 
\\ character, 70 
\" character, 70 
\ character, 72 
\b character, 72 
\f character, 71 
\n character, 71-72 
\r character, 71-72 
\t character, 72 
(underscore), identifiers, 36 
(underscores) 

method, iee _init_ method 
overview of, 227-229 
(addition) operator, 40, 43^4, 71 
(concatenation) operator, 71, 245, 318 
(augmented assignment) operator, 44, 71 
- (assignment) operator, 37, 117 

(paragraph comments), 16-17 
% (remainder or modulo) operator, 41-44 
C ) parentheses, 16, 476 

* (multiplication) operator, 40, 43^4 

* (repetition) operator, 245, 318 

** (exponentiation) operator, 40-41, 434-4 
[ ]. see Index operator [ ] 

{} (curly braces), 479, 488 
< (left-justification), 79 
»> (statement prompt), 15-16 
lOOOBaseT, 8 

A 

Abbreviations, avoiding in identifiers, 36 
abs 0,64-65 

Absolute filenames, 440-441 
Accessor (getter), 227, 232 

accumulateO, 366 
acosO, 65-67 

Activation record, functions, 175 
Activefill argument. Canvas, 283 
Actual parameter, 173 
Add button, 467470 
add method 

add element to set, 479, 495 
bouncing balls, 347 
add_cascade method, 290, 292 


add_command method, 290-293 
Addition operator (-f) 

concatenating two strings, 71 
defined, 40 

forming augmented assignment operators, 44 
operator precedence rule, 4344 
addPoint 0,371-372 
Address book case study, 467470 
addThisPointO, 371-372 
Aggregated object, 419421 
Aggregating class, 419421 
Aggregating object, 419421 
Aggregation relationships, 419421 
Algorithms, translating into programs, 32 
and operator, 110-113 
animate method, 300, 347 
Animations 

bouncing balls, 345-347 
defined, 332 

developing in Tkinter, 297-300 
Anonymous objects, 219 
append method, list class, 320 
Appending data to end of file, 447 
Arcs 

displaying figures, 425427 
displaying in canvas, 280-283 
Arguments 

defining functions with default, 189-190 
passing by reference values, 180-183 
positional and keyword, 179-180 
Arithmetic operators, 117 
Arithmetic/logic unit, CPU, 3 
Arrays, 314 

arrow argument. Canvas, 283 

Arrow keys, 8 

ASCII 

character sets, 534 

generating random characters with, 191-192 

ord() and chr(), 69 
overview of, 68 
asinO, 65-67 
askfloatO, 302 
askintegerO, 302 
askokcancel (), 302 
askopenfi1ename(), 448449, 451 
asksaveasfi1ename(), 448449, 451 
askstringC), 302 
askyesnoO, 301 
askyesnocance! (), 302 
Assemblers, 10 
Assembly language, 10 
Assign value, to variable, 33 
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Assignment operators 
augmented, 44 
defined, 37 

operator precedence and associativity, 117 
Assignment statements 

assigning values to variables, 37 
copying lists with, 330 
overview of, 36-38 
simultaneous, 38-39 
Association 

aggregation and composition as, 419^21 
overview of, 418-419 
Associativity, operator, 117-118 
Attributes, as object state, 216 
Augmented assignment operator (; -), 44, 71 

B 

Backslash (\), 69-70 
Bal 1 class, bouncing halls, 343-345 
Base (radix), decimal number system, 536 
Base case 

computing factorials, 500-502 
computing Fibonacci numbers, 504-505 
finding directory size, 511 
problem solving using recursion, 506-507 
recursive selection sort, 508-509 
Towers of Hanoi, 514 

BaseException class, custom exceptions, 460^61 
Behavior of objects, 216 
Binary digits (bits), 4-5 
Binary files, vs. text, 440 
Binary I/O, using pickling 
address book, 467^70 
detecting end of file, 466^67 
overview of, 465-466 
Binary numbers 

conversions between decimal and, 537 
conversions between hexadecimals and, 538-539 
defined, 536 
Binary operator, 40 
Binary search, lists 
overview of, 339-341 
recursive, 509-510 
bi nd method, mouse events, 294-297 
Binding global variables, 188 
Bindings, Tkinter, 294-297 
Birthdays, guessing, 96-99, 379-381 
Bits (binary digits), 4-5 
Blind extensions, inheritance, 404 
Blueprint, 216-217, 222 

BMI (body mass index), case study, 107-108, 233-235 
bool 0,93 

Boolean (logical) operators, 110-116 
Boolean accessor, 227 
Boolean expression, 92-93 

Bottom-up implementation, large programs, 196-198 
Bouncing balls, case study, 345-347 
Brackets [], 315, 319-320 


break keyword 

adding to loops, 151-152 
displaying prime numbers, 155 
use with caution, 152-153 
break statement, exception handling, 455-456 
Bus, for computer components, 2-3 
Button widget, Tkinter 
defined, 275 
example, 279 

processing events, 273-275 
Buttons 

adding image, 288-290 
creating, 272-273 

creating address book with binary I/O, 469 
creating bouncing balls, 346 
creating menus, 291 
creating reusable clock GUI, 415 
Bytes, 4—5 

C 

Cable modem, 8 
Call stacks, 175-176 
Callback functions 

binding mouse event, 294—297 
defined, 303 

GUI programming in Tkinter, 292, 294, 296 
processing events in Tkinter, 274, 287 
Callback handler 

binding mouse event with, 294 
reusable clock, 415 
Sodoku GUI, 377 
Callback method, 291, 451 
Caller, 173 
Calling functions 

call stacks and, 175-176 
defined, 15 
overview of, 173-175 
camelCase, variables, 36 
Canvas widget 

creating animations in Tkinter, 297-300 
creating bouncing balls, 346 
creating pop-up menu, 293 
defined, 275 

displaying images, 288-289 
reusable clock GUI, 414-418 
scrolling contents in, 300-301 
as source for key event, 295-296 
using, 280-283 

capita! ize method, 249-250 
Case sensitivity 

converting strings, 249-250 
identifiers, 36 
named constants, 39, 108 
Python programs and, 16 
Case studies 

body mass index, 107-108 

bouncing balls, 345-347 

convert decimals to hexadecimals, 185-187 
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convert hexadecimals to decimals, 254-256 

counting occurrences of each letter, 335-338, 451^52 

counting occurrences of words, 492-494 

Course class design, 421^23 

current time, 46-48 

deck of cards, 327-329 

deck of cards GUI, 329-330 

directory size, 510-511 

distances, 52-53 

Eight Queens, 518-520 

factorials, 500-503 

Fibonacci numbers, 503-505 

fractals, 515-517 

generate random ASCII characters, 191-192 
guessing birthdays, 96-99, 379-381 
guessing numbers, 136-138 
leap years, 113-114 
loan calculator, 287-288 
lottery, 114—116 
lotto numbers, 325-327 
Monte Carlo simulation, 150-151 
multiple subtraction quiz, 139-140 
palindromes, 253-254 
palindromes, recursive, 506-507 
predict future tuition, 149-150 
prime numbers, 154-155 
random walk, 156-157 
Rational class, 258-263 
repeat subtraction quiz, 136 
reusable clock, 414^18 
reusable graphics functions, 199-201 
subtraction quiz, multiple, 139-140 
subtraction quiz, repeat, 136 
taxes, 108-110 
Towers of Hanoi, 512-515 
CD-Rs, 6 
CD-RWs, 6 

CDs (compact discs), 6 
ceilC), 65-67 

center method, strings, 251-252 
Central processing unit (CPU), 3^ 
ch(),69 
Characters 

accessing in strings, 234 
ASCII, 68, 534 

escape sequences for special, 69-70 
generating random ASCII, 191-192 
ordC) and chr() and, 69 
strings and, 67-68 

stripping whitespace from string, 250-251 
Unicode, 68 

Checkbutton widget, Tkinter 
adding image, 288-290 
defined, 275 
examples of, 276-279 
Chinese zodiac signs, 103-105 
chr(),69 

ci rcl e() command. Turtle, 22-24 
circle method, 81-82 


Circles 

computing area of, 32-34 
computing area with 1 f statement, 95-96 
computing in high-level language, 10 
defining class for, 217-221 
defining own exception classes, 461^62 
displaying on canvas, 296-297 
drawing in Turtle, 23-24, 81-83 
with exceptions, 458-459 
hiding data fields, 227-228 
location of point in, 118-119 
Monte Carlo simulation, 150-151 
reusable graphics functions for, 199-201 
Class abstraction, 229-232 
Class definition, 217 
Class encapsulation, 229-232 
Classes 

abstraction and encapsulation, 229-232 
constructing objects with, 218-219 
defining for objects, 216-218 
designing Course class, 421^23 
designing for stacks, 423—425 
developing FigureCanvas class, 425^27 
example using, 220-222 
hiding data fields, 227-229 
immutable vs. mutable objects and, 225-226 
in OOP, 13, 233-235 
overview of, 216 
relationships among, 418^21 
review, 235-239 
sel f parameter and, 219-220 
Tkinter GUI widget, 275-280 
UML class diagrams, 222-225 
Client, class, 221 
Clock speed, CPUs, 3^ 

Closest pair problem, 368-372 
Coding 

functions for reusable, 172 
incrementally, 137 
loop design strategies, 138-139 
think before, 137, 148 
Color 

bouncing balls, 346-347 
constructing Tkinter widget, 276, 278-279 
drawing in Turtle, 21-22, 83-84 
drawing Olympics rings logo, 23-24 
Column indexes, 362-364 
col umnspan parameter, grid manager, 284 
Command option, Tkinter, 274 
Command window, 14-16 
Commas, separating elements in lists, 315 
Comments, 16-19 
Common errors, 19 
Communication devices, 8 
Compact keyboards, 7 
Comparing strings, 246 
Comparison operators 
comparing lists, 319 
comparing strings, 246-247 
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Comparison operators (continued) 

operator precedence and associativity, 117 
overview of, 92 
special methods and, 257 
Compiler, translating source code, 10-11 
Composition 

aggregation and, 419^21 
designing Stack class, 423^25 
Compound expressions, 110-111 
Computers 

hardware, see Hardware components 
operating system, 12-13 
overview of, 2-3 
programming languages, 9-12 
review, 25-29 
Concatenation operator ( i) 
lists, 318 
strings, 71, 245 
Conditional expressions, 116 
Conditional operator, 113 
Condition-controlled loops, 134 
config method, menus, 292 
Confirmation, controlling loop with user, 140 
Console 

defined, 14 

reading input from, 34-35 
reading strings from, 71-72 
Console input, 14 
Console output, 14 
Constants 

named, 39, 108, 276 
overview of, 39 
Constructor 

creating objects from classes, 218-219 
creating strings, 242 
UML class diagrams, 222 
continue keyword, 151-153 
Contract (template or blueprint), 216-217, 222 
Control unit, CPU, 3 
Conversion code 

formatting floating-point numbers, 77-78 
formatting in scientific notation, 78 
formatting integers, 79 
formatting strings, 79-80 
Converting strings, 249-250, 254-256 
Coordinate system, canvas, 282 
Copy reference, lists, 330 
Copying lists, 330-331 
Core, CPU, 4 
cos 0,65-67 

Count backward, rangeO, 144 
count method, 248-249, 320 
Counter-controlled loops, 134, 143 
Counting keywords, case study, 486-487 

Counting occurrences of each letter, case study, 335-338, 451^52 
Counting occun'ences of words, case study, 492-494 

countLettersO 

counting each letter in file, 337-338, 452 
exception handling, 455 
retrieving data from Web, 453^54 


Course elass, 421^23 
CPU (central processing unit), 3^ 
create_arc method, 282 
create_image method, 288-290 
create_l ine method, 282 
create_oval method, 282 
create_polygon method, 282 
create_text method, 282 
createListO, 336-337 
Curly braces { }, 479, 488 
Current time 

displaying, 46-48 

GUI class to display reusable clock, 414-418 

currentHour, 47 
currentHinute, 47 
currentSecond, 47 

Cursor, mouse, 8 

D 

Daily temperature and humidity problem, 378-379 
Data fields 
defined, 216 
hiding, 227-229 

implementing associations with, 419 
as instance variables, 219 
rational number, 259-262 
subclass, 400^01 
in UML class diagrams, 222 
Data hiding, 227-229 
Data structure, 476 
Data types 
numeric, 40 
Python coding and, 33 

datetime class, reusable clock GUI, 415^18 

De Morgan’s law, 112 

Debugging, and stepwise refinement, 199 

Decimal index, ASCII character set in, 534 

Decimals 

conversions between binary numbers and, 537 

conversions between hexadecimals and, 185-187, 254-256, 538 

defined, 536 

decimalToHexC), 184—185 
Deck of cards, case study, 327-330 
def keyword, 173 

Default arguments, 189-190, 333-334 
degrees (), 65-67 
Delete items from dictionary, 489 
Delete key, 8 

denominator field, rational number, 259-262 
Deployment, software development process, 49 
Descriptive names 
constants, 39 
identifiers, 36 
variables, 32 
Design 

Course class, 418 
strategies for loop, 138-139 
Dialog boxes, 301-302, 448^51 
diet class, 491 
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Dictionaries 

adding, modifying, and retrieving values, 488^89 
counting occurrences of words, 492-494 
creating, 488 
defined, 487^88 
deleting items, 489 
equality test, 490 
lenOand, 490 
looping items, 489 
methods, 491-492 
overview of, 487-488 
review, 495^98 
testing if keys are in, 490 
Dictionary entry, 488 
Dictionary item, 488 
di fference method, sets, 481^83 
Digital subscriber line (DSL), 8 
Digital versatile or video discs (DVDs), 6 
Digits, identifiers using, 36 
Direct recursion, 503 
Directory path, 440 
Directory size, 510-511 
Disks, 6 

displayTriangl es(), 517 

Distance, computing, 52-54 
Divide-and-conquer strategy, function abstraction 
benefits of, 199 

implementation details, 196-199 
overview of, 192-193 
top-down design, 193-195 

top-down or bottom-up implementation, 195-196 
Documentation, guidelines, 18-19 
doneC) command. Turtle, 24 
dot method, 119 
dot operator ( ), 219 
Dot pitch, 8 
Double quotes (") 

enclosing strings in, 67 
use of in this book, 68 
Doub1 eVar, 278 

drawClock method, reusable clock, 417^18 
Drawing 

creating animations, 297-300 
shapes, 81-83 
Drives, 6 

DSL (digital subscriber line), 8 
dumpC), 465-467 
DVD-R, 6 
DVD-RW, 6 

DVDs (digital versatile or video discs), 6 
Dynamic binding, and polymorphism, 410-411 


E 

Eight Queens, case study, 518-520 

Elementary programming, see Programming, elementary 

el se clause, exception handling, 456 

Encapsulation (information hiding), 192 

Encoding scheme, 4 

endswith method, strings, 248-249 


Entry widget, Tkinter 
defined, 275 
example of, 277-278 
Sudoku GUI problem, 375-377 
EOFError, 466^67 
EOL (end-of-line) character, 69-70 
Equality operators 

precedence rule for, 117 
testing dictionaries, 490 
testing sets, 480-481 
EiTors 

programming, 19-21 
selection statement, 105-106 
Escape sequences, character, 69-70 
eval O, 34, 45 
Evaluate expressions, 43 
Events 

creating loan calculator, 287-288 
processing in Tkinter, 273-275 
Tkinter GUI program and, 273 
Exception handling 

binary lO using pickling, 465^67 
creating address book, 467-470 
defined, 440 

defining custom classes for, 460-465 
processing exceptions, 460 
raising exceptions, 457^59 
review, 470^74 
writing code, 454^57 
Exceptions, defined, 454 
Execute program, 16 
expo, 65-67 

expand option, pack manager, 284-285 
Exponentiation operator (**), 40^1, 43^4 
Expressions 

Boolean, 92-93 
conditional, 116 
evaluating internally, 117-118 
operator precedence and, 43^4 
overview of, 36-38 
extend method, list class, 320-321 


F 

fabs 0,65-67 
factorial 0,500-503 
Factorials, case study, 500-503 
Faster button, animation, 300 
Fibonacci numbers, computing, 503-505 
FigureCanvas class, 425-427 
File dialogs 

creating text editor, 449-451 
displaying Open and Save As, 448-449 
filename, opening file, 440-441 
Files 

appending data, 447 
binary lO using pickling, 465^67 
counting each letter in, 451-452 
creating address book, 467^70 
custom exception classes, 460-465 
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Files (continued) 

detecting end of, 466-467 
exception handling, 454-457 
file dialogs, 448^51 
opening, 440-441 
processing exceptions, 460 
raising exceptions, 457-459 
reading all data from, 445-447 
reading data from, 443^45 
retrieving data from Web, 452^54 
review, 470^74 
storing data in, 440 
testing existence of, 443 
text input and output, 440 
writing and reading numeric data, 447-448 
writing data, 441-443 
fill option, pack manager, 284-285 
f i nal 1 y clause, exception handling, 456^57 
f i nd method, strings, 248-249 
First half of list, binary searches, 339-341 
Fixed cells, 372 

Float division operator (/), 40, 44 
Floating-point numbers 

causing loop-continuation-condition errors, 147-148 
formatting, 77-78 
not using in loop control, 141-142 
overview of, 40 
scientific notation, 42-43 
type conversions and rounding, 45-46 
Flowcharts, 95, 100 
Fonts 

creating Tkinter widget, 276, 278-279 
drawing in Turtle, 83-84 
for clause, 319-320 
for loops 

iterating strings, 247 
nesting, 145-146 
overview of, 143-145 
performance for lists vs. sets, 485-486 
reading data from all files, 445-446 
traversing all keys in dictionary, 489-490 
traversing elements in tuple, 476-477 
traversing list elements, 319 
Formal parameters, function header, 173 
formate) 

numbers, 76-79 
strings, 79-80 

format method, strings, 251-252 
Formatting 

numbers, 76-79 
strings, 79-80, 251-253 
Fractals, case study, 515-517 
Frame widget, Tkinter, 275-279 
Free cells, 372 
Function abstraction 
benefits of, 199 

implementation details, 196-199 
overview of, 192-193 
top-down design, 193-195 

top-down or bottom-up implementation, 195-196 


Function header, 173 
Function keys, 7 
Functions 

calling, 173-176 
common, 64-65 

converting decimals to hexadecimals, 185-187 
default arguments, 189-190 
defined, 15 

generating random ASCII characters, 191-192 
list, 316 

lists, passing to, 332-334 
lists, returning from, 334-335 
mathematical, 65 
modularizing code with, 183-185 
object, 75-76 
order of, 175 
overview of, 172 
parentheses for, 16 

passing arguments by reference values, 180-183 

passing mutable objects to, 225-226 

passing two-dimensional lists to, 365-367 

positional and keyword arguments, 179-180 

recursive, see Recursion 

reusable graphics, 199-201 

review, 201-213 

scope of variables, 187-189 

string, 243 

syntax for, 172-173 

with/without return values, 176-179 

G 

Games, detecting location of object, 118-119 
Garbage collection, 330 
GBs (gigabytes), 5 
gedO, 183-184, 259 
GCD (greatest common divisor) 
finding, 148-149 
modularizing code, 183-184 
reducing rational number, 259-262 
General-purpose programming language, 13 
Geometic shapes, see Turtle 

Geometry managers, Tkinter, 278, 283-286, 287-288 
get method 

class abstraction and encapsulation, 232 
client access to data field, 227-228 
dictionaries, 491 

getCradeO, 177-178 
getMatrixO, 366 

getRandomLowerCaseLetterC), 335-337 
getSizeC), 511 

getter (accessor), 227, 232 
GHz (gigahertz), 4 
Gigabytes (GBs), 5 
Global statements, 188 
Global variables, 187-188 
gotoO, 22-23, 83-84 
Graphics programming 

computing distance, 52-54 
drawing with Canvas widget, 282 
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reusable functions, 199-201 
stalling with Turtle, see Turtle 

Greatest common divisor, see GCD (greatest common divisor) 
Grid, 372-373 

Grid manager, Tkinter, 211, 282-284 
Guessing birthdays case study, 96-99, 379-381 
Guessing lottery, 114—116 
GUI modules, geometric shapes, see Turtle 
GUI programming 

closest pair problem, 370-372 
creating bouncing balls, 347 
reusable clock, 414^18 
Sudoku problem, 375-377 
using Tkinter. see Tkinter 


H 

Handlers, 274 
Hard disks, 6 
Hardware components 
bits and bytes, 4-5 
communication devices, 8 
CPU, 3^ 

input and output devices, 7-8 
memory, 5 
overview of, 2-3 
review, 8-9 
storage devices, 5-7 
Hashable elements, sets, 479 
Heap, 175 

Helper functions, recursive, 507-510 
Hertz (Hz), 3^ 

Hexadecimal index, ASCII, 534 
Hexadecimals 

conversions between binary numbers and, 538-539 
conversions between decimals and, 185-187, 
254-256, 538 

creating bouncing balls, 346-347 
defined, 536 

hexCharToDecimal (), 255-256 
hexToDecimal (), 255-256 
hideturtleC), 84 

High-level languages, 10-11 
History, Python’s, 13-14 
Honor’s algorithm, 255 
H-b'ee, 500 
Hz (hertz), 3^ 


I 

id 0,74-75 
Identifiers 

named constants as, 39 
overview of, 36 
Identity, object, 216 

IDLE (/nteractive DeveLopment Environment), 14—15 
i f clause, list comprehensions, 319 
i f statements, see also Nested i f statements 
computing taxes, 108-109 
example of, 96 


overview of, 95-96 
selection statement errors, 105-106 
if-elif-else statements, 102-105 
i f-el se statements 

recursive functions, 505-506 
two-way, 100-102 
Images 

deck of cards GUI program, 330 
displaying with Tkinter, 288-290 
Immutable objects 

vs. mutable objects, 225-226 

numbers and strings as, 181 

with same content, storing in one object, 243 

in tuples, 478 

Implementation, software development, 49, 51 
i n operator 

counting keywords program, 486^87 
defined, 258 
lists, 318 

searching lists with, 338 
sets, 479 
strings, 245 

testing if key is in dictionary, 490 
tuples, 476-477 

Incremental development and testing, 110 
Indentation 

avoiding for statements, 16 
causing selection statement errors, 105-106 
index method, list class, 320, 337-338 
Index operator [ ] 
creating lists, 315 
overview of, 319-320 
strings, 243 
tuples, 477 

Index variables, 316-317, 319 

IndexError, 317 

Indexes, list, 316-317 

Indirect recursion, 503 

Infinite loops, 135 

Infinite recursion, 503 

Information hiding (encapsulation), 192 

Inheritance 

object class and, 406-409 
overriding methods, 405^06 
overview of, 400 

polymorphism and. see Polymorphism 
review, 428^38 

superclasses and subclasses, 400^05 
_init^ method 
constructing objects, 218-219 
creating address book, 468, 470 
defining classes, 217 
initializing object, 407-409 
invoking for superclass, 402 
not including in UML diagram, 222 
Initializer 

class abstraction and encapsulation with, 231 
constructing objects with, 218 
defined, 217 

hiding data fields with, 227-229 
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Initializing two-dimensional lists, 364 

inputC), 254 
Input 

devices, 7-8 
errors, 20 
file, 370 

reading from console, 34-35 

inputC) 

reading input from console, 34 
reading strings from console, 71-72 
returning string from keyboard, 242 
Input redirection, loops, 142-143 
Input values, initializing lists, 364 
Inputting lists, 322 
Insert key, 8 

insert method, list class, 320-321 
Insertion sort, lists, 345-347 
Instance, as object, 217 
Instance methods, 219, 231 
Instance variables, 219-220 
Instantiation, 217 
into 

converting Boolean value to integer, 93 
overview of, 40 
type conversions, 45-46 
Integer division operator (//), 40, 43^4 
Integers 

converting Boolean value to, 93 
formatting, 79 

generating random numbers, 93-94 
overview of, 40 

type conversions and rounding, 45-46 
/nteractive DeveLopment Environment (IDLE), 
14-15 

Interactive mode, Python in, 16 
Interpreted, Python as, 13 
Interpreter 

executing Python from, 13 
translating source code with, 10-11 
intersection method, sets, 481^83 
IntVar, widgets, 278 

Inval idRadiusException class, 461^62 
Invoking functions, 15 
lOError exception, 454-456 
_io.TextIOWrapper class, 441^43 
Is-a relationships, inheritance modeling, 404 
isfileO,443 
isinstanceC), 411^14 
isPal indromeO, 506-508 
isPal indromeHelper(), 508 
isPrimeO, 184-185 
i sStopped variable, 299-300, 347 
isTooCloseToOtherPoints method, 
371-372 

isValidAtCgrid), 374-375 
isVal id(grid), 373, 375-376 
Iteration 

of loops, 134 
recursion vs., 520 
of strings, 247 


Joining lines implicitly, 35 
Justify format 
numbers, 79 
text in widget, 276 

K 

KBs (kilobytes), 5 

key element, searching lists, 338-341 
Key events, Tkinter, 294-297 
Keyboards, 7-8 

Key/value pairs, dictionaries, 487^89 
Keyword arguments, 179-180, 189 
Keywords (reserved words) 
counting program, 486-487 
list of Python, 533 
not used for identifiers, 36 
kilobytes (KBs), 5 

L 

Labels 

adding image to, 288-290 
building deck of cards GUI, 330 
using Tkinter widgets, 272-273, 275, 278-279 
LANs (local area networks), 8 
Launching Python, 14-15 
Leap years, determining, 113-114 
Left shift, for lists, 322 
Left-justification (<), 79 
lenQ 

dictionaries, 490 
lists, 316 

sets, 479, 482^83 
strings, 234, 258 
tuples, 476-477 
Ten method, 258 

_ 1 en _ function, strings, 258 

Letters, used by identifiers, 36 

Lexicographical ordering, 319 

Line break character (\), 69-70 

Line comments, 16 

Line continuation symbol (\), 35 

Line numbers, 16 

Linear search, lists, 338-339 

1inearSearchC), 338-339 

list class, 315 

List comprehensions, 319-320 

Listbox widget, scrolling contents, 300-301 

Lists 

bouncing balls, 345-347 
coding simplification, 322-325 
comparison operators vs., 319 
concatenation operator + and, 318 
copying, 330-331 

counting each letter in file, 451^52 
counting occurrences of each letter, 335-338 
creating, 315 
creating from tuple. All 
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deck of cai'ds, 327-329 
deck of cai-ds GUI, 329-330 
functions for, 316 
index operator [ ] and, 316-317 
inputting, 322 

list comprehensions, 319-320 

lotto numbers, 325-327 

methods, 320-321 

in/not in operators and, 318 

overview of, 314 

passing to functions, 332-334 

repetition operator (*) and, 318 

returning from functions, 334—335 

review, 348-359 

searching, 338-341 

sequence operations for, 315 

sets vs., 479 

shifting, 322 

sorting elements in, 341-345 
splitting strings into, 321-322 
traversing elements in for loop, 319 
tuples vs., 476 
Literals 

Boolean, 93 
defined, 40 

I justC) method, strings, 251-252 
loadC), binary 10 using pickling, 465-467 
loadAddress method, AddressBook, 470 
Loan calculator program, 287-288 
Local area networks (LANs), 8 
Local variables, 187 
log 0,65-67 
Logic eiTors, 20 
Logical operators 

generating lottery program, 114-116 
operator precedence and associativity, 117 
overview of, 110-113 
testing, 111-113 
Loop body, 134 
Loop-continuation-condition 
defined, 134 

numeric errors caused by, 147-148 
terminating, 135 
while loop and, 135 
Loops 

adding break and continue keywords to, 151-153 

displaying prime numbers, 154-155 

finding greatest common divisor, 148-149 

for. see for loops 

minimizing numerical errors, 147 

Monte Carlo simulation, 150-151 

nested, 145-146 

overview of, 134 

predicting future tuition, 149-150 
random walk simulation, 156-157 
review, 157-169 

telling program to execute statements repeatedly, 134 
traversing all keys in dictionary, 489 

while, see while loops 
Loss of precision, 74 


Lottery, 114-116 
Lottery, guessing, 114-116 
Lotto numbers, case study, 'i25-'i21 
lower method, 249-250, 451^52 
Lowercase letters, random, 191-192 
Low-level language, 10 
1 strip method, strings, 251 

M 

Machine language, code in, 9-10 
Machine stack, 175-176 
Maintenance, software development, 49 
Map, as dictionary, 488 
Matched lists, binary searches, 339-341 
Mathematical computations, performing, 18 
Mathematical functions 
case study, 72-74 
common Python, 64—65 
drawing various shapes, 81-83 
drawing with colors and fonts, 83-85 
formatting numbers, 76-79 
formatting strings, 79-80 
guessing birthdays, 99 
objects and methods, 74—76 
review, 85-89 

strings and characters, 67-72 
types of, 65-67 

max() 

defined, 64-65 
lists, 316 

sets, 479, 482^83 
strings, 234 
tuples, 476-477 

Mbps (million bits per second), and high-speed NICs, 8 

MBs (megabytes), 5 

Megabytes (MBs), 5 

Members, accessing object, 219-220 

Memory, 5 

Menu widget, Tkinter, 275 
Menubutton widget, Tkinter, 275 
Menus, creating, 290-293 
Message widget, Tkinter, 275 
Methods 

defining for operators, 257 
defining object’s behavior with, 216 
dictionary, 491 

implementing associations with, 419 
as instance methods, 219 
introduction to, 75-76 
invoking, 220 
list, 320-321 
overriding, 405^06 
searching for strings, 248-249 
string testing, 247 
subclass, 400^01 
UML class diagrams, 222 
Methods, special 

checking palindromes, 253-254 
converting hexadecimals to decimals, 254-256 


550 Index 


Methods, special (continued) 

operator overloading and, 257-258 
Rational class, 258-263 
review, 263-270 

Million bits per second (Mbps), and high-speed NICs, 8 

min() 

defined, 64-65 
lists, 316 

sets, 479, 482-483 
tuples, 476^77 

Minimum number of coins, case study, 72-74 

Mixed arguments, 189 

Mnemonics, for assembly language, 10 

mode parameter, openC), 440-441 

Modems, 8 

Modifier keys, 8 

Modularizing code, 183-185 

Modules, 16, 183-184 

Monitors, 8 

Monte Carlo simulation, case study, 150-151 
Motherboards, 3^ 

Mouse 

binding events, 294—297 
as pointing device, 8 

specifying style of cursor for Tkinter widget, 276 
move method, animations in Tkinter, 297-300 
Multicore CPUs, 4 
Multidimensional lists 

calculating daily temperature and humidity, 

378-379 

guessing birthdays, 379-381 
overview of, 377-378 
passing lists to functions, 332 
review, 381-397 

two-dimensional, see Two-dimensional lists 
Multiple inheritance, 404^05 
Multiple solutions, for programs, 149 
Multiple values, returning, 190 
Multiple-choice test, grading, 367-368 
Multiplication operator (*), 40, 43-44 
Multiplication table, nested loops, 145-146 
Multiplicity of classes, in association, 419 
Multiprocessing (parallel processing), 13 
Multiprogramming, 13 
Multithreading, 13 

multi-way i f-el i f-el se statements, 102-105 
Mutable objects 

vs. immutable objects, 225-226 
passing lists to functions, 332 
in tuples, 478 
Mutator (setter), 227, 232 
myLi St [index], 316-317 

N 

Named constants 

computing body mass index, 108 
formatting text in widget, 276 
overview of, 39 
NameError class, 4604-61 


Naming conventions 
classes, 218 
constant, 39 
identifier, 36 
variable, 36 

nearestPointsO, closest pair problem, 369-372 
Negative indexes, lists, 317-318 
Nested i f statements 

computing body mass index, 107-108 
computing taxes, 108-109 
overview of, 102-105 
Nested lists, 362, 368 
Nested loops, 145-146 

_new _method, constructing objects, 407408 

Newline character (\n), 69-70 
NICs (network interface cards), 8 
No-Fly list, 492494 
None function, 178 
not i n operator 
lists, 318, 338 
sets, 479 
strings, 245-246 

testing if key is in dictionary, 490 
tuples, 476 
not operator 

as logical operator, 110-111 
testing, 111-113 
Number systems, 536-539 
Numbers, see also Mathematical functions; 
Random numbers 
computing factorials, 500-503 
computing Fibonacci, 503-505 
deck of cards, 327-329 
deck of cards GUI, 329-330 
displaying prime, 154-155 
formatting, 76-79 
formatting floating-point, 77-78 
formatting in scientific notation, 78 
guessing, 136-138 
as immutable objects, 181 
lotto numbers, 325-327 
objects and methods, 74—76 
performing mathematical computations, 18 
writing and reading to file, 447448 
numerator field, rational numbers, 259-262 
Numeric data types, 4043 
Numeric keypad, 7-8 
Numeric operators 

augmented assignment operators, 44 
evaluating expressions and operator precedence, 
4344 

overview of, 4042 
scientific notation, 4243 
type conversions and rounding, 4546 
Numerical errors, 141-142, 147-148 

O 

object class, 406409 

Object member access operator, 219 
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Object-oriented programming, see OOP (object-oriented 
programming) 

Object-oriented thinking, 233-235 
Objects 

accessing members of, 219 
class abstraction and encapsulation, 229-232 
constructing, 218-219 
defining classes for, 216-218 
detecting location of, 118-119 
example using classes, 220-222 
hiding data fields, 227-229 
immutable vs. mutable, 225-226 
introduction to, 74-76 
object-oriented thinking, 233-235 
overview of, 216 
review, 235-239 
sel f parameter, 219-220 
strings with same content are the same, 242 
UML class diagrams, 222-225 
Off-by-one-error, loops, 135, 317 
Olympics rings logo program, 23-24 
OOP (object-oriented programming) 
creating GUI objects, 216 
procedural programming vs., 233-235 
Python using, 13 
openC), files, 440-442 
Open dialog box, 448-449 
open File method, 451 
Opening fdes, 440-441 
Operands, 40, 45-46 
Operations 
list, 315 
set, 481-485 
tuple, 476 

Operator associativity, 117-118 
Operator overloading, 257-258 
Operator precedence, 43^4, 117-118 
Operators 

augmented assignment operators, 44 
logical, 110-113 
numeric, 40^3 
or operator, 110-113 

ord(),69 

Order of functions, 175 
OS (operating system), 12-13 
os module, 510-511 
os. path module, 443 
outfile object, 447-448 
Output devices, 7-8 
Output redirection, loops, 142-143 
Ovals 

bouncing balls program, 347 
creating pop-up menu, 293 
displaying with Canvas widget, 280-283 
displaying with FigureCanvas, 425^27 
drawing on canvas, 281-283 
enlarge/shrink circle program, 296 
Overflow, and floating-point numbers, 42 
Overhead, recursion, 520 
Overriding methods, inheritance, 405-406 


P 

Pack manager, Tkinter, 273, 284-285 
padx option, grid manager, 284 
pady option, grid manager, 284 
Page Down key, 8 
Page Up key, 8 
Palindromes 

checking if strings are, 253-254 
recursive helper functions, 508 
solving using recursion, 506-507 
Parallel processing (multiprocessing), 13 
Parameters 

function header, 173 

passing positional or keywords arguments to, 179-180 
Parentheses ( ), 16, 476 
Pass-by-value, 180 

Passing arguments by reference values, 180-183 
Pen, in Turtle, 22-23 
pendotvn () , Turtle 

drawing Olympics rings logo, 24 
drawing various shapes, 81-82 
drawing with colors and fonts, 83-84 
moving pen to any location, 23 
pens1ze(). Turtle, 81-84 
penupO, Turtle 

drawing Olympics rings logo, 24 
drawing various shapes, 81-82 
drawing with colors and fonts, 83-84 
moving pen to any location, 23 
Performance 

avoiding recursion if concerned about, 520 
lists vs. sets and, 485^86 
Personal income tax, computing, 108-109 
Photoimage objects 
creating menu, 291-292 
displaying images, 288-289 
Pickling, binary I/O using, 465^67 
Pixels, and screen resolution, 8 
Place manger, Tkinter, 286 
Points, drawing in circle, 118-119 
Polygons, drawing in canvas, 280-283 
Polymorphism 

class relationships, 418-421 
defined, 409 

designing class for stacks, 423^25 
designing Course class, 421^23 
and dynamic binding, 409^11 
FigureCanvas class, 425^27 
inheritance and. see Inheritance 
isintanceO and, 411-414 
reusable clock program and, 414^18 
review, 428^38 
pop method, list class, 321 
pop(key) method, dictionaries, 491 
Pop-up menus, 292-294 
Positional arguments, 179-180, 189 
pound sign (#), preceding comment line, 16 
pow(), 64—65 

Precedence rule, operator, 43^4 
Prime numbers, 154-155, 184-185 
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printO 

defined, 15 

displaying string on monitor, 242 
printing without newline character, 70 
writing simple program, 34 
print statement 

creating Python source code files, 17 
defined, 15 

joining lines explicitly and, 35 
printGradeC), 176-178 
printPrimeNumbersO, 184-185 
Private data fields, 227-229 
Private methods, 227-229 
Problems 

executing statements based on conditions, 92 
solving using recursion, 505-507 
solving with elementary programming, 32 
writing simple program, 32-34 
Procedural programming, 233-235 
processAdd method, address book, 470 
processFi rst method, address book, 470 
processKeyEvent callback function, 295-296 
processLineC), dictionary, 493^94 
processMouseEvent callback function, 295-296 
processNext method, address book, 470 
Programming 

documentation and style, 18-19 
errors, 19-21 
graphics, 21-24 
overview of, 2 
review, 25-29 

writing simple programs, 32-34 
Programming, elementary 

augmented assignment operators, 44 
computing distances, 52-53 
displaying current time, 46^8 

evaluating expressions and operator precedence, 43^4 

identifiers, 36 

named constants, 39 

numeric data types and operators, 40^3 

reading input from console, 34-35 

review, 54-61 

simultaneous assignments, 38-39 
software development, 48-52 
type conversions and rounding, 45 
variables, assignment statements, and expressions, 36-38 
writing simple program, 32-34 
Programming languages 
assembly, 10 
defined, 9 
high-level, 10-11 
machine, 9-10 
overview of, 2 
review, 11-12 
Programs, 2 
Properties 

creating Tkinter widget, 276 
mouse and key event, 295 
as object state, 216 
Pseudocode, algorithms in, 32 


Punctuation, avoiding at end of statements, 16 
.py extension, 16, 183-184 
Python, introduction 

creating source files, 16-17 
graphics programming, see Turtle 
history of, 13-14 
launching, 14-15 
mathematical computations, 18 
as programming language, 2 
Python 2 vs. 3, 13 
review, 25-29 

Q 

Quotation marks ( ), strings, 16 

R 

radian (), 65-67 

Radiobutton widget, 275-280, 288-290 
Radix (base), decimal number system, 536 
raise keyword, processing exceptions, 460 
Raising exceptions, 457^59 
RAM (random-access memory), 5 
randintC) 

bouncing balls, 346 
defined, 93 

denoting constants with, 39 
guess number, 138 
lottery program, 115 
multiple subh'action quiz, 139 
random ASCII characters, 191 
random numbers, 93-95 
random shuffling, 364-365 
random walk, 156 

reading and writing numbers to files, 447 
repeat subtraction quiz, 136 
subtraction quiz, 101-102 
random (), 94-95 

Random ASCII characters, case study, 191-192 
random module 

lottery program, 114-116 
random numbers, 93-94 
shuffling elements in lists randomly, 316 
Random numbers 
generating, 93-95 
generating lottery program, 115 
two-way if-else statements, 100-102 
writing to files using strings, 447^48 
Random walk, case study, 156-157 
RandomCharacter module, 335-338 
randrangeC), 94—95 
rangeO, 143-146 
Rational class, case study, 258-263 
Rational numbers, 258-263 
Raw string, absolute filenames, 441, 444 
read method 

reading data from all files, 445^47 
reading data from file, 440, 443-445 

readASol utionO, 373, 375 
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Reading 

data from all files, 445-447 
data from files, 443^45 
data from Web, 452^54 
numbers in files, 447^48 

read!ine(), 443-445 
read1 i nes () , 443^47 
Real types, 40 
Rectangles 

creating pop-up menu, 293 
displaying with canvas, 280-283 
displaying with FigureCanvas, 425^27 
Recursion 

computing factorials, 500-503 

computing Fibonacci numbers, 503-505 

Eight Queens problem, 518-520 

finding directory size, 510-511 

fractals, 515-517 

iteration vs., 520 

overhead, 520 

overview of, 500 

problem solving using, 505-507 

recursive helper functions, 507-510 

review, 522-529 

tail, 520-522 

Towers of Hanoi, 512-515 
Recursive calls, 500-501, 506 
Recursive functions, 500-503, 505-506 
recursiveBinarySearchO, 509-510 
redisp1ayBa11 method, 347 
Reference values 

passing arguments by, 180-183 
returning lists from functions, 334—335 
Regular expressions, 322 
Relationships among classes 

aggregation and composition, 419^21 
association, 418-419 
is-a relationship, 404 
using inheritance to model is-a, 418 
Relative filenames, 440 
Remainder or modulo operator (%), 40-44 
remove method 

list class, 321, 347 
manipulating sets, 479^80 
Repetition operator (■■), 245, 318 
repl ace method, strings, 249-250 
replacePunctuationsC), 493^94 
reprC), 444 

Requirements specification, software development, 48-50 
Reserved words (keywords) 
case study, 486^87 
list of Python, 533 
not used for identifiers, 36 
Resources, OS allocating and assigning, 12 
Resume button, animation, 300 
Retrieving data from Web files, 452^54 
return None statement, 178 
return statement, 178, 190-191 
Return value, functions, 173, 176-179 
Reusable clock GUI, case study, 414-418 


Reusable code, 172, 199-201 

reverse method, list class, 321, 334—335 

rfind method, strings, 248-249 

rjust method, strings, 251-252 

round (), 45, 64-65 

Rounding, 45^6 

Rows, two-dimensional lists, 362-364 
rowspan parameter, grid manager, 284 
rstrip method, strings, 251 
Rules, identifier, 36 
Runtime errors, 20, 35 
Runtime stack, 175-176 
RuntimeError class, 457-459, 461 

S 

Save As dialog box, displaying, 448-449 

saveAddress method, AddressBook, 470 

saveFile method, text editor, 451 

Scheduling operations, OS, 13 

Scientific notation, 42-43, 78 

Scope of instance variable, 220 

Scope of variables, 37, 187-189 

Screen resolution, 8 

Script files, 16 

Scrollbars, 300-302 

Searching 

lists, 338-341,509-510 
substrings, 248-249 

Second half of list, binary search approach, 339-341 
Selection sort 
lists, 342-343 
recursive, 508-509 
Selections 

boolean types, values, and expressions, 92-93 
common errors, 105-106 
computing body mass index, 107-108 
computing taxes, 108-110 
conditional expressions, 116 
detecting location of object, 118-119 
determining leap years, 113-114 
generating random numbers, 93-95 
guessing birthdays, 96-99 
i f statements, 95-96 
logical operators, 110-113 
lottery program, 114-116 

nested if and multi-way i f-el i f-el se statements, 102-105 
operator precedence and associativity, 117-118 
overview of, 92 
review, 119-132 

two-way if-else statements, 100-102 
sel f parameter 

_ i n i t _ method, 218 

not including in UML diagram, 222 
working with, 219-220 
Self-avoiding walk, simulating, 157 
Sentinel-controlled loop, 140-142 
Sequence operations, lists, 315 
Sequence types, see lists; strings 
Set difference, 481^83 
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Set intersection, 481^83 
set methods, 227, 232 
Set symmetric difference, 482 
Set union, 481-483 

setAddress method, 470 
Sets 

counting keywords, 486-487 
creating, 479 
equality test, 480-481 
lists vs., 479 

manipulating and accessing, 479-480 
operations, 481^85 
performance of lists vs., 485^86 
review, 495^98 
subsets and supersets, 480 
Setter (mutator) 

class abstraction and encapsulation, 232 
defined, 227 
Shapes 

displaying with Canvas widget, 280-283 
drawing with colors and fonts, 83-84 
drawing with turtle, 81-83 
Shifting lists, 322 
Short-circuit AND operator, 113 
shortestDi stance variable, closest pair problem, 369 
showerrorO, 301 
showinfoO, 301 
showwarningO, 301 
shufneO,316, 329-330 
Shuffle button, 329-330 
side option, pack manager, 285 
Sierpinski triangle, case study, 514-517 
Simultaneous assignments, 38-39 
sin 0,65-67 
Single quotes ('), 67-68 
si eepTi me variable, animation, 300, 346 
Slicing operator 
lists, 317-318 
strings, 244-245 
tuples, 477 

Slower button, animation, 300 
Software 

for computer, 2 
development process, 48-52 
examples of, 2 
sort method, list class 
defined, 321 

sorting elements in list, 341-345 
sorting two-dimensional lists, 365 
sortHelperO, 508-509 
Source files, 16-17 

Source program or source code, high-level languages, 10- 

Spacing style, programming, 19 

Special characters, 16, 69-70 

Special methods, see Methods, special 

Specifiers, format, 76-80 

Speed, CPU clock, 3^ 

split method, str class, 321-322 

Splitting strings, into lists, 321-322 

sqrtC), 65-67 


Stack-overflow exception, recursion, 520 
Stack traceback, 454 
Stacks 
call, 175 

designing Stack class for modeling, 423^25 
overview of, 423 

[start : end], slicing list, 317-318 
startswith method, strings, 248-249 
State, object, 216 
Statement prompt (>»), 15-16 
Statements 

high-level language, 10 
invoking value-returning functions as, 173 
Step value, rangeC), 144 
Stepwise refinement 
benefits of, 199 

implementation details, 196-199 
overview of, 192-193 
top-down design, 193-195 

top-down or bottom-up implementation, 195-196 
sticky option, grid manager, 284 
Still Clock class, clock GUI, 414^18 
Stop button, animation, 300 
Stopping condition, see Base case 
Storage devices, 5-7 
strO,71 
str class 

comparing strings, 246 
concatenation operator (+), 245 
converting strings, 249-250 
creating strings, 242-243 
defined, 242 

formatting strings, 251-253 

functions for strings, 243 

index operator [] , 243 

iterating string, 247 

i n operator, 245 

repetition operator (•■), 245 

review, key terms and summary, 263 

review, programming exercises, 263-270 

searching for substrings, 248-249 

slicing operator, 244-245 

strings, 245-246 

stripping whitespace characters from string, 250-251 
testing strings, 247-248 
__str_ method, 407^09 
Strings 

and characters, 67-70 
comparing, 246 
concatenation, 71 
concatenation operator (-f), 245 
converting, 249-250 
converting numbers into, 71 
creating, 242-243 
creating tuples from, 476 
defined, 15, 242 

displaying with Canvas widget, 281 
enclosing with quotation marks, 16 
formatting, 79-80, 251-253 
functions for, 243 
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as immutable objects, 183 
index operator [ ], 243 
iterating, 247 

not i n operator, 245-246 

objects and methods, 74-76 

1 n operator, 245 

overview of, 242 

reading from the console, 71-72 

repetition operator ("), 245 

review, key terms and summary, 263 

review, programming exercises, 263-270 

searching for substrings, 248-249 

slicing operator [start ; end] , 244-245 

str class, see str class 

stripping whitespace characters from, 250-251 

testing, 247-248 

writing numbers to files using, 447^48 
stripC), strings, 76 
strip method, strings, 251, 254 
Stub, defined, 195-196 
Subclasses 
defined, 404 

inheritance and, 400-405 
method overriding and, 405^06 
polymorphism and dynamic binding, 409^11 
Subsets, 480 

Substrings, searching for, 248-249 
Subtraction operator ( ), 40, 43-44 
Subtraction quiz 
loop, 139-140 
repeating, 136 

two-way i f-el se statements, 101-102 
Sudoku problem, 371-372 
sum() 
lists, 316 

sets, 479, 482-483 
tuples, A16-A11 

Summing, two-dimensional lists, 364 
Superclasses 

inheritance and, 400-405 
method overriding and, 405^06 
polymorphism and dynamic binding, 409^11 
Supersets, 480 

swapCase method, strings, 249-250 

swi tch statements, recursive functions, 505-506 

symmetric_di fference method, sets, 482 

Syntax 

errors, 19-20 
rules, 19 

SyntaxError class, exceptions, 456-457, 461 

sys module, computing taxes, 109-110 

System analysis and design, software development, 49-50 

T 

tags argument. Canvas, 282-283 
Tail recursive, 520-522 
tan 0,65-67 

Tasks, controlling and monitoring, 12 
Taxes, computing, 108-110 


TBs (terabytes), 5 

Teamwork, with stepwise refinement, 199 

Templates, 216-217, 222 

Testing 

base cases, 511 
Boolean operators, 111-113 
custom exceptions, 462 
exceptions, 458^59 
existence of file, 443 
incremental development and, 110 
for key in dictionary, 490 
software development process, 49, 52 
stepwise refinement and, 199 
strings, 247-248 
Text editor, creating, 449^51 
Text files, vs. binary files, 440 
Text formatting, Tkinter widget, 276, 278-279 
Text input and output, files 
appending data, 447 
counting each letter in, 451-452 
file dialogs, 448-451 
opening, 440^41 
overview, 440 

reading all data from, 445^47 
reading data from, 443-445 
testing existence of, 443 
writing and reading numeric data, 447^48 
writing data, 441^43 
Text widget 

creating, 277-278 
creating text editor, 451 
defined, 275 

scrolling contents in, 300-301 
Think before coding, 137, 148 
Think recursively, 506 
timeO, 46^8 
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Python Quick Reference 


Console Input 

string = input("Enter a string: ") 
number = eval(input("Enter a number: ")) 

numberl, number2, numbers = eval(input("Enter three numbers, separated by commas: ") 
Console Output 
printCiteml, item2, ...) 

print(iteml, item2, end = "ending string") 


Random Numbers 

random.randint(a, b) # Return a random integer between a and b 
random.randrange(a, b) # Return a random integer between a and b - 1 
random. randomO # Return a random float between 0.0 and 1.0, excluding 1.0 


range Functions 



rangeCa, b) # Returns a sequence a, a + 1, 

. . . , b - 1 


range(b) # Same as range(0, b) 



range(a, b, k) # Returns a sequence a, a + 

k, a + 2k, .. 

., with the last number 

# in the sequence less than 

b 



Arithmetic Operators 

+ addition 

subtraction 
* multiplication 

/ float division 

// integer division 

% remainder 

** exponent 


Augmented Assignment Operators 


assignment 

+= 

addition assignment 

- = 

subtraction assignment 

*_ 

multiplication assignment 

/= 

float division assignment 

//= 

integer division assignment 

%= 

remainder assignment 

= 

exponent assignment 


Relational Operators 

< 

less than 

<= 

less than or equal to 

> 

greater than 

>= 

greater than or equal to 

== 

equal to 

1 = 

not equal 


Logical Operators 

and logical conjunction 
or logical disjunction 
not logical negation 


Simultaneous Assignment 

y = Yi X # Swap X with y 


Conditional Expression 

V = vl if condition else v2 


Defining Functions 

def functionName(parameters): 
statements 


loop statements 


selection statements 

while condition: 


if condition: 

statements 


statements 

# strings, lists, tuples 


if condition: 

# are examples of sequences 


statements 

for e in sequence: 


el se: 

statements 


statements 

for line in file: 


if conditionl: 

statements 


statements 



elif condition2: 

for key in dictionary: 


statements 

statements 


el se: 



statements 


Companion Web site: www.pearsonhighered.com/liang 










































Figure 1.17 


Figure 3.4 


Figure 3.5 



The program draws the Olympics rings logo. 



d 

J_J_ 


The program draws five shapes in different colors. 




Figure 5.5 The program plots sine function in blue and cosine function in red. 






















































Figure 9.36 Ten balls with random colors are displayed at random locations. 



Figure 9.39 The blue circle is dragged with the mouse. 



Figure 10.14 The program displays bouncing balls with control buttons. 



Figure 11.17 The program displays Os and Is randomly with a click of the Refresh button. 








































Connect Four 




74 Connect Four 

□□□□□□□ 

□□□□□□□ 

□□□□□□□ 

□□□□□□□ 

□□■□□□□ 

Start Over I 

□□□□□□□ 

□□□□□□□ 

□□□□□□□ 

□■■□□□□ 

Start Over | 


Figure 12.25 The program enables two players to play the Connect Four game. 



Figure 12.26 A Mandelbrot image is shown in (a) and a Julia set image is shown in (b). 



Figure 12.28 The program uses the BarChart class to display bar charts. 




























































































































































































































































































Figure 12.29 The program uses the PieChart class to display pie charts. 



Figure 15.11 queens[i] denotes the position of the queen in row i. 
























